_getche_nolock, _getwche_nolock

Article
03/26/2013

Obtient un caractère de la console avec l'écho et sans verrouiller le thread.

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

Valeur de retour

Retourne le caractère à lire.Il n'existe aucun retour en cas de erreur.

Notes

_getche_nolock et _getwche_nolock sont identiques à _getche et à _getwche sauf qu'ils ont pas protégé d'interférence par d'autres threads.Ils peuvent être plus rapides car elles n'entraînent pas la charge mémoire de verrouiller d'autres threads.Utilisez ces fonctions uniquement dans des contextes thread-safe tels que des applications à un seul thread ou où les handles appelants de portée déjà thread l'isolation.

Mappages de routines de texte générique

Routine de Tchar.h	_UNICODE et non définis _MBCS	_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> ou <wchar.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

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 
}