_getche, _getwche

Статья
04/10/2013

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

Важно
Этот API нельзя использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в разделе Функции 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     
}