Partager via

_getch, _getwch

  • Article

Obtient un caractère à partir de la console sans l’afficher.

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 _getch( void );
wint_t _getwch( void );

Valeur retournée

Retourne le caractère lu. Il n’existe aucun retour d’erreur.

Notes

Les _getch fonctions et _getwch lit un caractère unique à partir de la console sans faire écho au caractère. Pour lire une touche de fonction ou une touche de direction, chaque fonction doit être appelée deux fois. Le premier appel retourne 0 ou 0xE0. Le deuxième appel retourne le code d’analyse de clé.

Ces fonctions verrouillent le thread appelant et sont donc thread-safe. Pour les versions non verrouillées, consultez _getch_nolock, _getwch_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 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

Spécifications

Routine En-tête requis
_getch <conio.h>
_getwch <conio.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

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
}

abcdefy

Type 'Y' when finished typing keys: Y

Voir aussi

Console et port d’entrée/sortie (E/S)
_getche, _getwche
_cgets, _cgetws
getc, getwc
_ungetch, , _ungetwch_ungetch_nolock, ,_ungetwch_nolock