_getch, _getwch
Ruft ein Zeichen aus der Konsole ab, ohne es zu wiederholen.
Wichtig
Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.
int _getch( void );
wint_t _getwch( void );
Rückgabewert
Gibt das gelesene Zeichen zurück. Es gibt keine Fehlerrückgabe.
Hinweise
Die Funktionen _getch und _getwch lesen ein einzelnes Zeichen aus der Konsole, ohne das Zeichen Echo auszugeben. Mit keiner dieser Funktionen kann STRG+C gelesen werden. Beim Lesen einer Steuertaste oder einer Pfeiltaste muss jede Funktion zweimal aufgerufen werden. Der erste Aufruf gibt 0 oder 0xE0 und der zweite Aufruf den tatsächlichen Tastencode zurück.
Diese Funktionen sperren den aufrufenden Thread und sind daher threadsicher. Informationen zu nicht sperrenden Versionen finden Sie unter _getch_nolock, _getwch_nolock.
Zuordnung generischer Textroutinen
Tchar.h-Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_gettch |
_getch |
_getch |
_getwch |
Anforderungen
Routine |
Erforderlicher Header |
---|---|
_getch |
<conio.h> |
_getwch |
<conio.h> oder <wchar.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
// crt_getch.c
// compile with: /c
// This program reads characters from
// the keyboard until it receives a 'Y' or 'y'.
#include <conio.h>
#include <ctype.h>
int main( void )
{
int ch;
_cputs( "Type 'Y' when finished typing keys: " );
do
{
ch = _getch();
ch = toupper( ch );
} while( ch != 'Y' );
_putch( ch );
_putch( '\r' ); // Carriage return
_putch( '\n' ); // Line feed
}
Entsprechung in .NET Framework
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.