std::puts
| Definiert in Header <cstdio> |
||
| int puts( const char *str ); |
||
Schreibt jedes Zeichen des nullterminierten Strings str und ein zusätzliches Zeilenumbruchzeichen '\n' in den Ausgabestrom stdout, so als ob std::fputc wiederholt aufgerufen würde.
Das terminierende Nullzeichen von str wird nicht geschrieben.
Inhalt |
[bearbeiten] Parameter
| str | - | zu schreibender Zeichenstring |
[bearbeiten] Rückgabewert
Bei Erfolg wird ein nicht-negativer Wert zurückgegeben
Bei einem Fehler wird EOF zurückgegeben und der Fehlerindikator (siehe std::ferror) für stdout gesetzt.
[bearbeiten] Hinweise
Die Funktion std::puts hängt ein Zeilenumbruchzeichen an die Ausgabe an, während die Funktion std::fputs dies nicht tut.
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, falls der String länger war), einige geben einfach eine nicht-negative Konstante zurück.
Eine typische Fehlerursache für std::puts ist das Ausgehen des Speicherplatzes auf dem Dateisystem, wenn stdout in eine Datei umgeleitet wird.
[bearbeiten] Beispiel
#include <cstdio> int main() { int rc = std::puts("Hello World"); if (rc == EOF) std::perror("puts()"); // POSIX requires that errno is set }
Ausgabe
Hello World
[bearbeiten] Siehe auch
| schreibt einen Zeichenstring in einen Dateistream (function) | |
| (C++11) |
druckt formatierte Ausgabe nach stdout, einen Dateistream oder einen Puffer (Funktion) |
| C-Dokumentation für puts
| |
