fputs
| Definiert in Header <stdio.h>
|
||
int fputs( const char* str, FILE* stream );
|
(bis C99) | |
int fputs( const char* restrict str, FILE* restrict stream );
|
(seit C99) | |
Schreibt jedes Zeichen aus der nullterminierten Zeichenkette str in den Ausgabestrom stream, als ob wiederholt fputc ausgeführt würde.
Das abschließende Nullzeichen von str wird nicht geschrieben.
Parameter
| str | - | nullterminierte Zeichenkette, die geschrieben werden soll |
| stream | - | Ausgabestrom |
Rückgabewert
Bei Erfolg wird ein nicht negativer Wert zurückgegeben.
Bei Misserfolg wird EOF zurückgegeben und der Fehler-Indikator (siehe ferror()) für stream gesetzt.
Anmerkungen
Die verwandte Funktion puts fügt der Ausgabe ein Zeilenumbruchzeichen hinzu, während fputs die Zeichenkette unverändert schreibt.
Verschiedene Implementierungen geben unterschiedliche nicht negative Zahlen zurück: manche geben das zuletzt geschriebene Zeichen zurück, manche die Anzahl der geschriebenen Zeichen (oder INT_MAX, falls die Zeichenkette länger war), manche geben einfach eine nicht negative Konstante wie Null zurück.
Beispiel
#include <stdio.h>
int main(void)
{
int rc = fputs("Hello World", stdout);
if (rc == EOF)
perror("fputs()"); // POSIX requires that errno is set
}
Ausgabe:
Hello World
Referenzen
- C23-Standard (ISO/IEC 9899:2024):
- 7.21.7.4 The fputs function (p: TBD)
- C17-Standard (ISO/IEC 9899:2018):
- 7.21.7.4 The fputs function (p: TBD)
- C11-Standard (ISO/IEC 9899:2011):
- 7.21.7.4 The fputs function (p: 331-332)
- C99-Standard (ISO/IEC 9899:1999):
- 7.19.7.4 The fputs function (p: 297)
- C89/C90-Standard (ISO/IEC 9899:1990):
- 4.9.7.4 The fputs function
Siehe auch
(C99)(C11)(C11)(C11)(C11) |
gibt formatierte Ausgabe auf stdout, einen Dateistrom oder einen Puffer (Funktion) |
| schreibt eine Zeichenkette auf stdout (Funktion) | |
| liest eine Zeichenkette von einem Dateistrom (Funktion) | |
C++-Dokumentation für fputs
| |