_getche, _getwche

Получает символ из консоли с отображением.

Важно!

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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

Возвращаемое значение

Возвращает считанный символ. Не возвращается ошибка.

Замечания

Функции _getche и _getwche считывают отдельный символ из консоли с отображением, то есть символ выводится в консоли. Эти функции нельзя использовать для считывания сочетания CTRL+C. _getwche При _getche чтении ключа функции или клавиши со стрелкой функция должна вызываться дважды. Первый вызов возвращает значение 0 или 0xE0, а второй вызов возвращает фактический код ключа.

Эти функции блокируют вызывающий поток, поэтому они потокобезопасны. Сведения о версиях без блокировки см. в статье _getche_nolock. _getwche_nolock

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_gettche	_getche	_getche	_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
}

abcdefy

Type 'Y' when finished typing keys: abcdefyY

См. также

Консоль и порт ввода-вывода
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock