fputs

 

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 fputs( const char*          str, FILE*          stream );		(bis C99)
int fputs( const char* restrict str, FILE* restrict stream );		(seit C99)

Schreibt jedes Zeichen des nullterminierten Strings str in den Ausgabestrom stream, als ob wiederholt fputc aufgerufen würde.

Das abschließende Nullzeichen von str wird nicht geschrieben.

Parameter

str	-	Nullterminierter Zeichenstring, der geschrieben werden soll
stream	-	Ausgabestrom

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 verwandte Funktion puts fügt ein Zeilenumbruchzeichen an die Ausgabe an, während fputs den String unverändert schreibt.

Verschiedene 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.

Beispiel

Führen Sie diesen Code aus

#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 Die Funktion fputs (S. TBD)

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

• 7.21.7.4 Die Funktion fputs (S. TBD)

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

• 7.21.7.4 Die Funktion fputs (S. 331-332)

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

• 7.19.7.4 Die Funktion fputs (S. 297)

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

• 4.9.7.4 Die Funktion fputs

Siehe auch

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