_getch, _getwch

Obtiene un carácter de la consola sin repetición.

Sintaxis

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

Valor devuelto

Devuelve el carácter leído. No se devuelve ningún error.

Comentarios

Las funciones _getch y _getwch leen un solo carácter de la consola sin repetir el carácter. Para leer una tecla de función o una tecla de dirección, se debe llamar a cada función dos veces. La primera llamada devuelve 0 o 0xE0. La segunda llamada devuelve el código de examen de clave.

Estas funciones bloquean el subproceso de llamada y, por lo tanto, son seguras para subprocesos. Para las versiones que no son de bloqueo, consulte _getch_nolock, _getwch_nolock.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Requisitos

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

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

abcdefy

Type 'Y' when finished typing keys: Y

Vea también

E/S de consola y de puerto
_getche, _getwche
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock