Compartilhar via


_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.

Consulte também

Referência

Console e E/S de porta

_cgets, _cgetws

getc, getwc

_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock