_getche, _getwche

Article
03/26/2013

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

Valeur de retour

Retourne le caractère à lire.Il n'existe aucun retour en cas de erreur.

Notes

Les fonctions d' _getche etd'_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 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 _getche_nolock, _getwche_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
_getche	_getche	_getch	_getwche

Configuration requise

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

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

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     
}