_getch, _getwch
Obtient un caractère de la console sans écho.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.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 à lire.Il n'existe aucun retour en cas de erreur.
Notes
Les fonctions d' _getch etd'_getwch lisent un caractère unique de la console sans l'écho le caractère.Aucune de ces fonctions ne peut être utilisée pour lire CTRL+C.En lisant une touche de fonction ou une touche de déplacement du curseur, chaque fonction doit être appelée deux fois ; le premier appel retourne 0 ou 0xE0, et le deuxième appel retourne un code de touche réel.
Ces fonctions verrouillent le thread appelant et sont donc thread-safe.Pour les versions correctes de verrouillage, consultez _getch_nolock, _getwch_nolock.
Mappages de routines de texte générique
Routine de Tchar.h |
_UNICODE et non définis _MBCS |
_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 de compatibilité, consultez l' Compatibilité dans l'introduction.
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 l' Exemples d'appel de code non managé.