std::fputs
| Definiert in Header <cstdio> |
||
| int fputs( const char* str, std::FILE* stream ); |
||
Schreibt jedes Zeichen aus dem nullterminierten String str in den Ausgabestrom stream, als ob std::fputc wiederholt aufgerufen würde.
Das abschließende Nullzeichen von str wird nicht geschrieben.
Inhalt |
[edit] Parameter
| str | - | nullterminierter Zeichenstring, der geschrieben werden soll |
| stream | - | Ausgabestrom |
[edit] Rückgabewert
Bei Erfolg wird ein nicht-negativer Wert zurückgegeben
Bei einem Fehler wird EOF zurückgegeben und die Fehleranzeige (siehe std::ferror) für stream gesetzt.
[edit] Anmerkungen
Die verwandte Funktion std::puts hängt ein Zeilenumbruchzeichen an die Ausgabe an, während std::fputs den String unverändert schreibt.
Unterschiedliche Implementierungen geben unterschiedliche nicht-negative Zahlen zurück: Einige geben das zuletzt geschriebene Zeichen zurück, einige die Anzahl der geschriebenen Zeichen (oder INT_MAX, wenn der String länger war), einige geben einfach eine nicht-negative Konstante wie Null zurück.
[edit] Beispiel
#include <cstdio> int main(void) { int rc = std::fputs("Hello World", stdout); if (rc == EOF) std::perror("fputs()"); // POSIX requires that errno is set }
Ausgabe
Hello World
[edit] Siehe auch
| (C++11) |
druckt formatierte Ausgabe nach stdout, einen Dateistream oder einen Puffer (Funktion) |
| schreibt eine Zeichenkette nach stdout (function) | |
| schreibt einen Weitzeichenstring in einen Dateistream (Funktion) | |
| liest einen Zeichenstring aus einem Dateistream (function) | |
| C-Dokumentation für fputs
| |