_getche_nolock, _getwche_nolock

Articolo
03/26/2013

Ottiene un carattere dalla console di eco e senza bloccare il 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 identici a _getche e a _getwche ma non è protetto da interferenze da parte di altri thread.Potrebbe essere più veloce perché non comportano un sovraccarico di bloccare da altri thread.Utilizzare queste funzioni solo in contesti thread-safe come applicazioni a thread singolo o dove gli chiamante di ambito già threading di isolamento.

Mapping di routine a 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à nell'introduzione.

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 
}