_getche_nolock, _getwche_nolock

Obtient un caractère de la console avec echo et sans verrouillage.

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 dans les applications de la plateforme Windows universelle.

Syntaxe

int _getche_nolock( void );
wint_t _getwche_nolock( void );

Valeur retournée

Retourne le caractère lu. Il n’existe aucun retour d’erreur.

Notes

_getche_nolock et _getwche_nolock sont identiques à _getche et _getwche, à ceci près qu’elles ne sont pas protégées contre les interférences par d’autres threads. Ils peuvent être plus rapides parce qu’ils n’entraînent pas de surcharge de 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.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

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

Spécifications

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

Pour plus d’informations sur la compatibilité, consultez Compatibility.

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
}

abcdefy

Type 'Y' when finished typing keys: abcdefyY

Voir aussi

Console et port d’entrée/sortie (E/S)
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock