_getche, _getwche

Ruft ein Zeichen aus der Konsole ab und wiederholt es.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

int _getche( void );
wint_t _getwche( void );

Rückgabewert

Gibt das gelesene Zeichen zurück. Es gibt keine Fehlerrückgabe.

Hinweise

Die Funktionen _getche und _getwche lesen ein einzelnes Zeichen aus der Konsole mit Wiederholung ab. Das heißt, dass das Zeichen an der Konsole angezeigt wird. Mit keiner dieser Funktionen kann STRG+C gelesen werden. Wenn _getche eine _getwche Funktionstaste oder eine Pfeiltaste gelesen wird, muss die Funktion zweimal aufgerufen werden. Der erste Aufruf gibt 0 oder 0xE0 zurück, und der zweite Aufruf gibt den tatsächlichen Schlüsselcode zurück.

Diese Funktionen sperren den aufrufenden Thread und sind daher threadsicher. Informationen zu nicht gesperrten Versionen finden Sie unter _getche_nolock, _getwche_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
_gettche	_getche	_getche	_getwche

Anforderungen

Routine	Erforderlicher Header
_getche	<conio.h>
_getwche	<conio.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_getche.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 = _getche();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch( ch );
   _putch( '\r' );    // Carriage return
   _putch( '\n' );    // Line feed
}

abcdefy

Type 'Y' when finished typing keys: abcdefyY

Siehe auch

Konsolen- und Port-E/A
_cgets, _cgetws
getc, getwc
_ungetch, , _ungetwch_ungetch_nolock_ungetwch_nolock