Partager via


_getche, _getwche

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     
}
  

É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

_cgets, _cgetws

getc, getwc

_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock