puts

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Datei-Ein-/Ausgabe

Typen und Objekte
stdinstdoutstderr          FILE fpos_t
Funktionen Datei-Zugriff fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush Unformatierte Ein-/Ausgabe fgetc fgets fputc fputs getchar getsgets_s (bis C11)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) Formatierte Eingabe scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	Direkte Ein-/Ausgabe fread fwrite Formatierte Ausgabe printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

Definiert in Header <stdio.h>
int puts( const char* str );

Schreibt jedes Zeichen des nullterminierten Strings str und ein zusätzliches Zeilenumbruchzeichen '\n' in den Ausgabestrom stdout, als ob wiederholt fputc aufgerufen würde.

Das abschließende Nullzeichen von str wird nicht geschrieben.

Parameter

str

-

zu schreibender Zeichenstring

Rückgabewert

Bei Erfolg wird ein nicht-negativer Wert zurückgegeben.

Bei einem Fehler wird EOF zurückgegeben und der Fehlerindikator (siehe ferror()) für stream gesetzt.

Hinweise

Die Funktion puts fügt ein Zeilenumbruchzeichen an die Ausgabe an, während die Funktion 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, wenn der String länger war), einige geben einfach eine nicht-negative Konstante zurück.

Eine typische Fehlerursache für puts ist, dass der Speicherplatz auf dem Dateisystem zur Neige geht, wenn stdout in eine Datei umgeleitet wird.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
 
int main(void)
{
    int rc = puts("Hello World");
 
    if (rc == EOF)
        perror("puts()"); // POSIX requires that errno is set
}

Ausgabe

Hello World

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.21.7.9 Die Funktion puts (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.21.7.9 Die Funktion puts (p: TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.21.7.9 Die Funktion puts (p: 333)

• C99-Standard (ISO/IEC 9899:1999)

• 7.19.7.10 Die Funktion puts (p: 299)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 7.9.7.10 Die Funktion puts

Siehe auch

fputs	schreibt einen Zeichenstring in einen Dateistream (Funktion)
printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11)	gibt formatierte Ausgaben nach stdout, an einen Dateistream oder in einen Puffer aus (Funktion)
C++-Dokumentation für puts