_getche_nolock _getwche_nolock

發行項
03/27/2013

從主控台取得字元有回應的和未鎖定的執行緒。

重要事項
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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

傳回值

傳回讀取的字元。不會回傳錯誤。

備註

_getche_nolock 和 _getwche_nolock 與秘密由其他執行緒的功能與 _getwche 類似，差別在於它們是相同的未受保護的 _getche 。因為它們不會造成額外負荷鎖定其他執行緒，可能會比較快。在安全執行緒內容中只使用這些函式 (例如單一執行緒應用程式呼叫或的範圍控制代碼已經執行緒隔離的地方。

泛用文字常式對應

Tchar.h 常式	未定義的 _UNICODE 和 _MBCS	已定義 _MBCS	已定義 _UNICODE
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

需求

程序	必要的標頭檔
_getche_nolock	<conio.h>
_getwche_nolock	<conio.h> 或 <wchar.h>

如需更多關於相容性的資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

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