_getche, _getwche
Obtém um caractere do console com 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 _getche( void );
wint_t _getwche( void );
Valor de retorno
Retorna a leitura de caracteres. Não há nenhum retorno de erro.
Comentários
As funções _getche e _getwche leem um único caractere do console com eco, o que significa que o caractere é exibido no console. 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 _getche_nolock, _getwche_nolock.
Mapeamentos da rotina de texto genérico
Rotina Tchar.h |
_UNICODE e _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_getche |
_getche |
_getch |
_getwche |
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
_getche |
<conio.h> |
_getwche |
<conio.h> ou <wchar.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade.
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
}
Equivalente ao .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.