_getche _getwche

Článek
03/26/2013

Získá znak z konzoly s echo.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

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

Vrácená hodnota

Vrátí znak číst.Není k dispozici žádné vrácení chyby.

Poznámky

_getche a _getwche funkce číst jeden znak z konzoly s odezvu, což znamená, že znak se zobrazí v konzole.Žádná z těchto funkcí lze použít ke čtení CTRL + C.Při čtení funkční klávesu nebo klávesu se šipkou, každá funkce musí být volána dvakrát; první volání vrátí 0 nebo 0xE0 a druhé volání vrátí skutečný kód.

Tyto funkce Uzamknout volající vlákno a proto jsou vláknově bezpečné.Bez uzamčení verze naleznete v _getche_nolock _getwche_nolock.

Mapování rutiny obecného textu

Byla zahájena rutina Tchar.h	_UNICODE a _MBCS není definováno	_MBCS, definice	_UNICODE definována
_getche	_getche	_getch	_getwche

Požadavky

Byla zahájena rutina	Požadované záhlaví
_getche	<conio.h>
_getwche	<conio.h> nebo <wchar.h>

Další informace o kompatibilitě v tématu Compatibility v úvodu.

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     
}