_getche, _getwche
Obtiene un carácter de la consola con repetición.
Importante
Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones de CRT no admitidas con /ZW.
int _getche( void );
wint_t _getwche( void );
Valor devuelto
Devuelve el carácter leído. No se devuelve ningún error.
Comentarios
Las funciones _getche y _getwche leen un solo carácter de la consola con repetición, es decir, el carácter se muestra en la consola. Ninguna de estas funciones se puede usar para leer CTRL+C. Al leer una tecla de función o de dirección, se debe llamar dos veces a cada función: la primera llamada devuelve 0 o 0xE0, y la segunda devuelve el código de tecla real.
Estas funciones bloquean el subproceso de llamada y son, por consiguiente, seguras para subprocesos. Para las versiones que no son de bloqueo, vea _getche_nolock, _getwche_nolock.
Asignaciones de rutina de texto genérico
Rutina 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 sobre compatibilidad, vea Compatibilidad.
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
}
Equivalente de .NET Framework
No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.