_getche, _getwche

Artigo
08/25/2010

Obtém um caractere de um console com eco.

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

Valor de retorno

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

Comentários

The _getch and_getwch functions read a single character from the console with echo, meaning that the character is displayed at the console.Nenhuma dessas funções pode ser usada para ler CTRL+C.Ao ler uma tecla de função ou uma tecla de direção, cada função deve ser telefonar duas vezes; a primeira telefonar retorna 0 ou 0xE0 e a segunda telefonar retorna o código real.

Essas funções bloquear o thread de chamada e, portanto, são thread-safe.Para as versões não-bloqueio, consulte _getche_nolock, _getwche_nolock.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_gettche	_getche	_getch	_getwche

Requisitos

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

Para obter mais informações de compatibilidade, consulte 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     
}

abcdey

Type 'Y' when finished typing keys: Y