_getch, _getwch

Artikel
06/09/2015

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  
}