_getch，_getwch

从无回显的控制台获取字符。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

int _getch( void );
wint_t _getwch( void );

返回值

返回读取的字符。 无错误返回。

备注

_getch 和 _getwch 函数从不回显字符的控制台读取单个字符。 若要读取函数键或箭头键，必须调用每个函数两次。 第一个调用返回 0 或 0xE0。 第二次调用返回键扫描代码。

这些函数会锁定调用线程，所以是线程安全的。 有关非锁定版本，请参阅 _getch_nolock、_getwch_nolock

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_gettch	_getch	_getch	_getwch

要求

例程	必需的标头
_getch	<conio.h>
_getwch	<conio.h> 或 <wchar.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

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

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

abcdefy

Type 'Y' when finished typing keys: Y

另请参阅

控制台和端口 I/O
_getche、_getwche
_cgets、_cgetws
getc、getwc
_ungetch、_ungetwch、_ungetch_nolock、_ungetwch_nolock