WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

getchar — C23-Datenstromfunktion

`getchar()` aus `<stdio.h>` holt das nächste Zeichen von der Standardeingabe und ist äquivalent zu `getc(stdin)`. Es liefert das als `unsigned char` gelesene und nach `int` gewandelte Zeichen oder den Makrowert `EOF` bei Dateiende oder Lesefehler.

Version: C23

Syntax

int getchar(void);

getchar() aus <stdio.h> holt das nächste Zeichen von der Standardeingabe und ist äquivalent zu getc(stdin). Es liefert das als unsigned char gelesene und nach int gewandelte Zeichen oder den Makrowert EOF bei Dateiende oder Lesefehler.

Das Beispiel schiebt mit ungetc ein Q auf stdin zurück und liest es tatsächlich durch getchar. Q 81 zeigt Zeichen und Wert im Ausführungszeichensatz; vor dem Lesen wird der Erfolg von ungetc geprüft.

Das Ergebnis in int, nicht char, speichern, sonst kann die Unterscheidung von EOF verloren gehen. EOF allein trennt Dateiende und Fehler nicht: feof(stdin) beziehungsweise ferror(stdin) prüfen und mit clearerr löschen. Eine Implementierung darf zusätzlich ein Makro bereitstellen; (getchar)() unterdrückt es und ruft die im Header deklarierte echte Funktion auf.

Beispiele

#include <stdio.h>
int main(void){if(ungetc('Q',stdin)==EOF)return 1;int character=getchar();if(character==EOF)return 1;printf("%c %d\n",character,character);return 0;}

Ergebnis

Q 81

Das Beispiel schiebt mit `ungetc` ein `Q` auf `stdin` zurück und liest es tatsächlich durch `getchar`. `Q 81` zeigt Zeichen und Wert im Ausführungszeichensatz; vor dem Lesen wird der Erfolg von `ungetc` geprüft.

Quellen