getchar, getwchar

Liest ein Zeichen aus der Standardeingabe.

Syntax

int getchar();
wint_t getwchar();

Rückgabewert

Gibt das gelesene Zeichen zurück. Diese Funktionen warten auf Eingaben und geben erst zurück, wenn die Eingabe verfügbar ist.

Zum Anzeigen eines Lesefehlers oder einer Dateiendebedingung gibt getcharEOF zurück, und getwchar gibt WEOF zurück. 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 ist identisch mit _fgetchar, aber es wird als Funktion und als Makro implementiert.

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

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

TCHAR.H-Routine	_UNICODE und _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 UWP-Apps (Universelle Windows-Plattform) nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles stdin, stdout und stderr müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in UWP-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);
}

This textInput was: This text

Siehe auch

Stream-E/A
getc, getwc
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc