Namensräume
Varianten
Aktionen

putchar

Von cppreference.com
< c‎ | io
 
 
Datei-Ein-/Ausgabe
Typen und Objekte
        
Funktionen
Datei-Zugriff
(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 putchar( int ch );

Schreibt ein Zeichen ch nach stdout. Intern wird das Zeichen unmittelbar vor dem Schreiben in unsigned char konvertiert.

Äquivalent zu putc(ch, stdout).

Inhalt

[bearbeiten] Parameter

ch - zu schreibendes Zeichen

[bearbeiten] Rückgabewert

Bei Erfolg wird das geschriebene Zeichen zurückgegeben.

Im Fehlerfall gibt EOF zurück und setzt den Fehlerindikator (siehe ferror()) für stdout.

[bearbeiten] Beispiel

Zeigt putchar 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 = putchar(c);
 
    // Test whether EOF was reached.
    if (ret_code == EOF && ferror(stdout))
    {
        fprintf(stderr, "putchar() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 6);
        perror("putchar()");
        exit(EXIT_FAILURE);
    }
    putchar('\n');
 
    // putchar return value is not equal to the argument
    int r = 0x1070;
    printf("\n0x%x\n", r);
    r = putchar(r);
    printf("\n0x%x\n", r);
}

Ausgabe

abcdefghijklmnopqrstuvwxy
 
0x1070
p
0x70

[bearbeiten] Referenzen

  • C23-Standard (ISO/IEC 9899:2024)
  • 7.21.7.8 Die Funktion putchar (p: TBD)
  • C17-Standard (ISO/IEC 9899:2018)
  • 7.21.7.8 Die Funktion putchar (p: TBD)
  • C11-Standard (ISO/IEC 9899:2011)
  • 7.21.7.8 Die Funktion putchar (p: 333)
  • C99-Standard (ISO/IEC 9899:1999)
  • 7.19.7.9 Die Funktion putchar (p: 299)
  • C89/C90-Standard (ISO/IEC 9899:1990)
  • 4.9.7.9 Die Funktion putchar

[bearbeiten] Siehe auch

schreibt ein Zeichen in einen Dateistream
(Funktion) [bearbeiten]
C++ Dokumentation für putchar