_getche、_getwche

项目
06/09/2015

从控制台中获取字符，并需要回显。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（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>

有关兼容性的更多信息，请参见兼容性。

示例

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