_getche, _getwche

Ottiene un carattere dalla console e lo visualizza (echo).

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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

Valore restituito

Restituisce il carattere letto. Non viene restituito alcun errore.

Osservazioni:

Le funzioni _getche e _getwche leggono un singolo carattere dalla console e lo visualizzano nella console (echo). Nessuna di queste funzioni può essere usata per leggere CTRL+C. Quando _getche o _getwche legge un tasto funzione o un tasto freccia, la funzione deve essere chiamata due volte; la prima chiamata restituisce 0 o 0xE0 e la seconda restituisce il codice della chiave effettivo.

Queste funzioni bloccano il thread chiamante e pertanto sono thread-safe. Per le versioni non di blocco, vedere _getche_nolock, _getwche_nolock.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_gettche	_getche	_getche	_getwche

Requisiti

Ciclo	Intestazione obbligatoria
_getche	<conio.h>
_getwche	<conio.h> o <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

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

Vedi anche

I/O della console e della porta
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock