_getch, _getwch

Articolo
03/26/2013

Ottiene un carattere dalla console senza eco.

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 di_getwch edi _getch letti un singolo carattere dalla console senza restituire il carattere.Nessuna di queste funzioni possono essere utilizzate per leggere CTRL+C.Durante la lettura di un tasto funzione o un tasto di direzione, ogni funzione deve essere chiamato due volte; la prima chiamata restituisce 0 o 0xE0 e i secondi risultati della chiamata del codice chiave.

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

Mapping di routine a 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à nell'introduzione.

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  
}