_getch, _getwch

Artikel
03/12/2013

Ruft ein Zeichen von der Konsole ohne 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 _getch( void ); wint_t _getwch( void );

Rückgabewert

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

Hinweise

Die _getch und _getwch-Funktionen lesen ein einzelnes Zeichen in der Konsole, ohne das Zeichen Echo auszugeben.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 _getch_nolock, _getwch_nolock.

Zuordnung generische 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 Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

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  
}