_getche_nolock, _getwche_nolock

Articolo
06/09/2015

Ottiene un carattere dalla console, con echo e senza bloccare la thread.

Importante

Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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

Valore restituito

Restituisce il carattere letto. Nessun ritorno di errore.

Note

_getche_nolock e _getwche_nolock sono identiche a _getche e _getwche ad eccezione del fatto che non proteggono dalle interferenze da parte di altre thread. Potrebbero essere più veloci perché non comportano un sovraccarico che blocca altri thread. Utilizzare queste funzioni solo in contesti thread-safe come applicazioni a thread singolo o dove l'ambito chiamante già gestisce l'isolamento del thread.

Mapping di routine su testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

Requisiti

Routine	Intestazione obbligatoria
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

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