_getche_nolock, _getwche_nolock

Artikel
03/12/2013

Ruft ein Zeichen von der Konsole mit Echo ab und ohne den Thread zu sperren.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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

Rückgabewert

Gibt das Zeichenlesen zurück.Es gibt keine Fehlerrückgabe.

Hinweise

_getche_nolock und _getwche_nolock sind zu _getche und zu _getwche außer dass ihnen identisch, die nicht von der Fehler durch andere Threads geschützt werden.Sie können möglicherweise schneller, da sie nicht der Mehraufwand für andere Threads heraus sperren verursachen.Verwenden Sie diese Funktionen nur in threadsichere Kontexten wie Singlethreadanwendung Anwendungen oder, wo die aufrufende Handles des Bereichs bereits Isolation erlauben.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

Anforderungen

Routine	Erforderlicher Header
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> oder <wchar.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

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