_getche, _getwche

 

Pour la documentation la plus récente de Visual Studio 2017 RC, consultez Documentation RC de Visual Studio 2017.

Obtient un caractère venant de la console avec écho.

System_CAPS_ICON_important.jpg 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 _getche( void );  
wint_t _getwche( void );  

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

Les fonctions _getche et _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 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 _getche_nolock, _getwche_nolock.

Mappages de routines de texte générique

Routine Tchar.h_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_getche_getche_getch_getwche
RoutineEn-tête requis
_getche<conio.h>
_getwche<conio.h> or <wchar.h>

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

// 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       
}  

abcdeyTaper « O » quand vous avez fini de taper les clés : O

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Console et port E/S
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock

Afficher: