_getche _getwche

發行項
03/26/2013

從有回應的主控台取得字元。

重要

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

int _getche( void );
wint_t _getwche( void );

傳回值

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

備註

_getche 和_getwche 函式從主控台讀取單一字元有回應的字元，就會顯示在主控台。這些函式都不可以用來讀取 CTRL+C。當讀取功能鍵或方向鍵時，必須呼叫兩次每個函式;第一個呼叫傳回 0 或 0xE0 和第二個呼叫會傳回實際按鍵的程式碼。

這些函式鎖定呼叫的執行緒並具備執行緒安全。如需非鎖定版本，請參閱 _getche_nolock _getwche_nolock。

泛用文字常式對應

Tchar.h 常式	未定義的 _UNICODE 和 _MBCS	已定義 _MBCS	已定義 _UNICODE
_getche	_getche	_getch	_getwche

需求

程序	必要的標頭檔
_getche	<conio.h>
_getwche	<conio.h> 或 <wchar.h>

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

範例

// crt_getche.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();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch( ch );
   _putch( '\r' );    // Carriage return
   _putch( '\n' );    // Line feed     
}