_getche
, _getwche
Obtient un caractère à partir de la console et l’affichent.
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 dans les applications de la plateforme Windows universelle.
Syntaxe
int _getche( void );
wint_t _getwche( void );
Valeur retournée
Retourne le caractère lu. Il n’y a pas de retour d’erreur.
Notes
Les fonctions _getche
et _getwche
lisent un caractère à partir de la console, avec affichage sur celle-ci. Aucune de ces fonctions ne peut être utilisée pour lire Ctrl+C. Quand _getche
ou _getwche
lit une touche de fonction ou une touche de direction, la fonction doit être appelée deux fois ; le premier appel retourne 0 ou 0xE0, et le deuxième appel retourne le code de clé réel.
Ces fonctions verrouillent le thread appelant et sont donc thread-safe. Pour les versions non verrouillées, consultez _getche_nolock
, _getwche_nolock
.
Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.
Mappages de routine de texte générique
Routine Tchar.h | _UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_gettche |
_getche |
_getche |
_getwche |
Spécifications
Routine | En-tête requis |
---|---|
_getche |
<conio.h> |
_getwche |
<conio.h> ou <wchar.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Exemple
// 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
}
abcdefy
Type 'Y' when finished typing keys: abcdefyY
Voir aussi
E/S de console et de port
_cgets
, _cgetws
getc
, getwc
_ungetch
, _ungetwch
, _ungetch_nolock
, _ungetwch_nolock
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour