Namespaces
Variants

fputs

Von de.cppreference.net
< c | io
 
 
Datei-Ein-/Ausgabe
Typen und Objekte
        
Funktionen
Dateizugriff
(C95)
Unformatierte Ein-/Ausgabe
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

Formatierte Eingabe
Direkte Ein-/Ausgabe
Formatierte Ausgabe
Dateipositionierung
Fehlerbehandlung
Operationen auf Dateien
 
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

gibt formatierte Ausgabe auf stdout, einen Dateistrom oder einen Puffer
(Funktion)
schreibt eine Zeichenkette auf stdout
(Funktion)
liest eine Zeichenkette von einem Dateistrom
(Funktion)