_getche, _getwche

Articolo
06/09/2015

Ottiene un carattere dalla console con echo.

Importante

Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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

Valore restituito

Restituisce il carattere letto. Nessun ritorno di errore.

Note

Le funzioni _getwche e _getche leggono un singolo carattere dalla console con echo, a indicare che il carattere è visualizzato nella console. Nessuna di queste funzioni può essere utilizzata per leggere CTRL+C. Durante la lettura di un tasto funzione o un tasto di direzione, ogni funzione deve essere chiamata due volte; la prima chiamata restituisce 0 o 0xE0 e la seconda ritorna il codice chiave corrente.

Queste funzioni bloccano il thread chiamante e sono pertanto thread-safe. Per una versione non bloccante, vedere _getche_nolock, _getwche_nolock.

Mapping di routine su testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_getche	_getche	_getch	_getwche

Requisiti

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

Per ulteriori informazioni sulla compatibilità, vedere 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     
}