getchar, getwchar

Artikel
06/09/2015

Liest ein Zeichen aus der Standardeingabe.

int getchar();
wint_t getwchar();

Rückgabewert

Gibt das gelesene Zeichen zurück. So einem Lesefehler oder eine Dateiende-Bedingung, getcharreturns EOF und getwchar gibt WEOF angeben. Verwenden Sie für getcharferror oder feof zur Fehler- oder Dateiendeüberprüfung.

Hinweise

Jede Routine liest ein einzelnes Zeichen aus stdin und erhöht den zugeordneten Dateizeiger, um auf das nächste Zeichen zu zeigen. getchar entspricht _fgetchar, ist jedoch als Funktion und Makro implementiert.

Diese Funktionen sperren den aufrufenden Thread und sind daher threadsicher. Eine nicht sperrende Version finden Sie unter _getchar_nolock, _getwchar_nolock.

Zuordnung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_gettchar	getchar	getchar	getwchar

Anforderungen

Routine	Erforderlicher Header
getchar	<stdio.h>
getwchar	<stdio.h> oder <wchar.h>

Die Konsole wird in Windows Store-Apps nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles, stdin, stdout und stderr, müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in Windows Store-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_getchar.c
// Use getchar to read a line from stdin.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;

    for (i = 0; (i < 80) && ((ch = getchar()) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }
       
    // Terminate string with a null character 
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);
}