_getch
, _getwch
Получает символ из консоли без отображения.
Внимание
Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.
Синтаксис
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
См. также
Консоль и порт ввода-вывода
_getche
, _getwche
_cgets
, _cgetws
getc
, getwc
_ungetch
, , _ungetwch
_ungetch_nolock
_ungetwch_nolock