_getch, _getwch

Artigo
06/09/2015

Obtém um caractere de console sem eco.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

int _getch( void );
wint_t _getwch( void );

Valor de retorno

Retorna a leitura de caracteres. Não há nenhum retorno de erro.

Comentários

_getch e_getwch funcionam leitura um único caractere de console sem ecoar o caractere. Qualquer uma dessas funções podem ser usadas para ler CTRL+C. Ao ler uma tecla de função ou uma tecla de seta, cada função deve ser chamada duas vezes. A primeira chamada retorna 0 ou 0xE0, e a segunda retorna o código real da chave.

Essas funções bloqueiam o thread de chamada e, portanto, são thread-safe. Para versões sem bloqueio, consulte _getch_nolock, _getwch_nolock.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_gettch	_getch	_getch	_getwch

Requisitos

Rotina	Cabeçalho necessário
_getch	<conio.h>
_getwch	<conio.h> ou <wchar.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

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