_getche, _getwche

Získá znak z konzoly s ozvěnou.

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 _getche( void );
wint_t _getwche( void );

Vrácená hodnota

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

Poznámky

_getwche Funkce _getche čtou jeden znak z konzoly s ozvěnou, což znamená, že se znak zobrazí v konzole. Žádná z těchto funkcí se nedá použít ke čtení ctrl+C. Když _getche nebo _getwche přečte funkční klávesu nebo šipkovou klávesu, musí být funkce volána dvakrát; první volání vrátí hodnotu 0 nebo 0xE0 a druhé volání vrátí skutečný kód klíče.

Tyto funkce zamknou volající vlákno a jsou proto bezpečné pro přístup z více vláken. Informace o neblokovacích verzích naleznete v tématu _getche_nolock, _getwche_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

Rutina Tchar.h _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_gettche _getche _getche _getwche

Požadavky

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

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

Příklad

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

Viz také

Vstupně-výstupní operace konzoly a portu
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, , _ungetch_nolock_ungetwch_nolock