Namespaces
Variants

fputc, putc

Von de.cppreference.net
< c | io
(Weitergeleitet von c/io/putc)
 
 
Datei-Eingabe/-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 ch in den angegebenen Ausgabestrom stream. putc() kann als Makro implementiert sein und wertet stream mehr als einmal aus, daher sollte das entsprechende Argument niemals ein Ausdruck mit Nebenwirkungen sein.

Intern wird das Zeichen unmittelbar vor dem Schreiben in unsigned char umgewandelt.

Parameter

ch - zu schreibendes Zeichen
stream - Ausgabestrom

Rückgabewert

Bei Erfolg wird das geschriebene Zeichen zurückgegeben.

Bei Misserfolg gibt es EOF zurück und setzt den Fehler-Indikator (siehe ferror()) auf stream.

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

Siehe auch

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