_getch, _getwch
Obtient un caractère venant de la console sans écho.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.
int _getch( void );
wint_t _getwch( void );
Valeur de retour
Retourne le caractère lu. Aucun retour d'erreur.
Notes
Les fonctions _getch et_getwch lisent un seul caractère de la console sans répercuter le caractère. Aucune de ces fonctions ne peut être utilisée pour lire Ctrl+C. En parcourant une touche de fonction ou une touche de direction, chaque fonction doit être appelée deux fois ; le premier appel retourne 0 ou 0xE0, et le deuxième appel retourne le code de touche demandé.
Ces fonctions verrouillent le thread appelant et sont donc thread-safe. Pour les versions non verrouillantes, consultez _getch_nolock, _getwch_nolock.
Mappages de routines de texte générique
Routine Tchar.h |
_UNICODE et _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_gettch |
_getch |
_getch |
_getwch |
Configuration requise
Routine |
En-tête requis |
---|---|
_getch |
<conio.h> |
_getwch |
<conio.h> ou <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité.
Exemple
// 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
}
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.