_getche, _getwche

Artigo
03/12/2013

Obtém um caractere de console com eco.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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

Valor de retorno

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

Comentários

_getche e_getwche funcionam leitura um único caractere de console com o eco, o que significa que o caractere é exibido no console.Quaisquer dessas funções podem ser usadas para ler CTRL+C.Ao ler uma tecla de função ou uma tecla de direção, cada função deve ser chamado duas vezes; a primeira chamada retorna 0 ou 0xE0, e a segunda chamada retorna o código de chave real.

Essas funções apenas e o segmento de chamada são como consequência com segurança.Para versões que não são de bloqueio, consulte _getche_nolock, _getwche_nolock.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_getche	_getche	_getch	_getwche

Requisitos

Rotina	Cabeçalho necessário
_getche	<conio.h>
_getwche	<conio.h> ou <wchar.h>

Para mais informações, consulte Compatibilidade de compatibilidade na introdução.

Exemplo

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