_getche, _getwche

Artikel
03/12/2013

Ruft ein Zeichen von der Konsole mit Echo ab.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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

Rückgabewert

Gibt das Zeichenlesen zurück.Es gibt keine Fehlerrückgabe.

Hinweise

Die _getche und _getwche-Funktionen lesen ein einzelnes Zeichen in der Konsole mit dem zurückgegeben und beabsichtigten, dass das Zeichen an der Konsole angezeigt wird.Keine dieser Funktionen können verwendet werden, um STRG+C zu lesen.Wenn eine Funktionstaste oder eine Pfeiltaste liest, muss jede Funktion zweimal aufgerufen werden; die ersten Aufruf gibt 0 oder 0xE0 und die zweiten Aufruf der tatsächliche Tastencode.

Diese Funktionen sperren den aufrufenden Thread und können daher threadsicher.Für nicht sperrend Versionen finden Sie unter _getche_nolock, _getwche_nolock.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_getche	_getche	_getch	_getwche

Anforderungen

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

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

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     
}