_getche, _getwche

Article
06/09/2015

Obtient un caractère venant de la console avec é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 _getche( void );
wint_t _getwche( void );

Valeur de retour

Retourne le caractère lu. Aucun retour d'erreur.

Notes

Les fonctions _getche et _getwche lisent un caractère unique de la console avec l'écho, ce qui signifie que le caractère est affiché dans la console. 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 _getche_nolock, _getwche_nolock.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_getche	_getche	_getch	_getwche

Configuration requise

Routine	En-tête requis
_getche	<conio.h>
_getwche	<conio.h> or <wchar.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

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     
}