Namespaces
Variants

fputc, putc

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
 
Definiert in Header <stdio.h>
int fputc( int ch, FILE* stream );
int putc( int ch, FILE* stream );

Schreibt ein Zeichen chin den gegebenen Ausgabestrom stream. putc()kann als Makro implementiert sein und wertet stream mehr als einmal aus, daher sollte das entsprechende Argument niemals ein Ausdruck mit Nebeneffekten sein.

Intern wird das Zeichen in unsigned char umgewandelt, kurz bevor es geschrieben wird.

Parameter

ch - zu schreibendes Zeichen
stream - Ausgabestrom

Rückgabewert

Bei Erfolg wird das geschriebene Zeichen zurückgegeben.

Bei Fehler wird EOF zurückgegeben und der Fehler-Indikator (siehe ferror()) auf stream gesetzt.

Beispiel

Zeigt putc mit Fehlerprüfung

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int ret_code = 0;
    for (char c = 'a'; (ret_code != EOF) && (c != 'z'); c++)
        ret_code = putc(c, stdout);

    // Test whether EOF was reached.
    if (ret_code == EOF && ferror(stdout))
    {
        perror("putc()");
        fprintf(stderr, "putc() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 7);
        exit(EXIT_FAILURE);
    }
    putc('\n', stdout);

    return EXIT_SUCCESS;
}

Ausgabe:

abcdefghijklmnopqrstuvwxy

Referenzen

  • C23-Standard (ISO/IEC 9899:2024):
  • 7.21.7.3 Die Funktion fputc (S. TBD)
  • 7.21.7.7 Die Funktion putc (S. TBD)
  • C17-Standard (ISO/IEC 9899:2018):
  • 7.21.7.3 Die Funktion fputc (S. TBD)
  • 7.21.7.7 Die Funktion putc (S. TBD)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.21.7.3 Die Funktion fputc (S. 331)
  • 7.21.7.7 Die Funktion putc (S. 333)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.19.7.3 Die Funktion fputc (S. 297)
  • 7.19.7.8 Die Funktion putc (S. 299)
  • C89/C90-Standard (ISO/IEC 9899:1990):
  • 4.9.7.3 Die Funktion fputc
  • 4.9.7.8 Die Funktion putc

Siehe auch

schreibt ein Zeichen in stdout
(Funktion)
C++-Dokumentation für fputc, putc