_getch, _getwch

Article
03/26/2013

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  
}