_getch, _getwch

Získá znak z konzoly bez zobrazení.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

int _getch( void );
wint_t _getwch( void );

Vrácená hodnota

Vrátí přečtený znak. Nevrátí se žádná chyba.

Poznámky

_getwch Funkce _getch čtou jeden znak z konzoly bez odezvy znaku. Pokud chcete přečíst funkční klávesu nebo klávesu se šipkou, musí být každá funkce volána dvakrát. První volání vrátí 0 nebo 0xE0. Druhé volání vrátí kód kontroly klíče.

Tyto funkce zamknou volající vlákno a jsou bezpečné pro přístup z více vláken. Informace o neblokovacích verzích naleznete v tématu _getch_nolock, _getwch_nolock.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Tchar.h Rutinní	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_gettch	_getch	_getch	_getwch

Požadavky

Rutina	Požadovaný hlavičkový soubor
_getch	<conio.h>
_getwch	<conio.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

// 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
}

abcdefy

Type 'Y' when finished typing keys: Y

Viz také

Vstupně-výstupní operace konzoly a portu
_getche, _getwche
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock