Partager via


_getch, _getwch

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  
}
  

Équivalent .NET Framework

Non applicable.Pour appeler la fonction C standard, utilisez PInvoke.Pour plus d'informations, consultez l' Exemples d'appel de code non managé.

Voir aussi

Référence

E/S de console et de port

_getche, _getwche

_cgets, _cgetws

getc, getwc

_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock