_getche_nolock, _getwche_nolock

Article
06/09/2015

Obtient un caractère depuis la console sans écho et sans verrouiller le thread.

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_nolock( void );
wint_t _getwche_nolock( void );

Valeur de retour

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

Notes

_getche_nolock et _getwche_nolock sont identiques à _getche et _getwche sauf qu'ils ne sont pas protégés des interférences avec d'autres threads. Elles peuvent être plus rapides, car elles n'entraînent pas la charge du verrouillage des autres threads. Utilisez ces fonctions uniquement dans les contextes thread-safe, tels que les applications à un seul thread ou lorsque la portée appelante gère déjà l'isolation des threads.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

Configuration requise

Routine	En-tête requis
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> or <wchar.h>

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

Exemple

// crt_getche_nolock.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_nolock();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch_nolock( ch );
   _putch_nolock( '\r' );    // Carriage return
   _putch_nolock( '\n' );    // Line feed 
}