_getch, _getwch

Статья
06/09/2015

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

Важно!

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

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

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

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

Заметки

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

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

Универсальное текстовое сопоставление функций

Подпрограмма 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  
}