_getch, _getwch

Articolo
06/09/2015

Ottiene un carattere dalla console senza 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 _getch( void );
wint_t _getwch( void );

Valore restituito

Restituisce il carattere letto. Nessun ritorno di errore.

Note

Le funzioni _getch e_getwch leggono un singolo carattere dalla console senza visualizzare il carattere. 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 le versioni non-locking, vedere _getch_nolock, _getwch_nolock.

Mapping di routine su testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_gettch	_getch	_getch	_getwch

Requisiti

Routine	Intestazione obbligatoria
_getch	<conio.h>
_getwch	<conio.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

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