_getche, _getwche

Artículo
04/10/2013

Obtiene un carácter de consola con generación de repetición.

Importante
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW.

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

Valor devuelto

Devuelve la lectura del carácter.No hay retorno de error.

Comentarios

_getche y _getwche funciona lectura un carácter individual de la consola con la generación de repetición, lo que significa que el carácter se muestra en la consola.Ninguna de estas funciones se pueden utilizar para leer CTRL+C.Al leer una tecla de función o una tecla de dirección, cada función debe llamar a dos veces; la primera llamada devuelve 0 o 0xE0, y la segunda llamada devuelve la clave real.

Estas funciones bloquean el subproceso de la llamada y son por consiguiente seguro para subprocesos.Para las versiones de modificación limitada de interpretación, vea _getche_nolock, _getwche_nolock.

Asignaciones de la rutina de Genérico- texto

Rutina de Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_getche	_getche	_getch	_getwche

Requisitos

Rutina	Encabezado necesario
_getche	<conio.h>
_getwche	<conio.h> o <wchar.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

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