_getch, _getwch

Article
06/09/2015

Obtient un caractère venant de la console sans é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 _getch( void );
wint_t _getwch( void );

Valeur de retour

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

Notes

Les fonctions _getch et_getwch lisent un seul caractère de la console sans répercuter le caractère. 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 _getch_nolock, _getwch_nolock.

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

Configuration requise

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

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

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  
}