_getche, _getwche

에코를 사용하여 콘솔에서 문자를 가져옵니다.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

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

반환 값

읽은 문자를 반환합니다. 오류 반환이 없습니다.

설명

_getche 및 _getwche 함수는 에코를 사용하여 콘솔에서 단일 문자를 읽습니다. 즉, 문자가 콘솔에 표시됩니다. 이 중 어느 것도, CTRL + C를 읽을 수 없습니다. 함수 키 또는 화살표 키를 읽거나 _getwche 읽을 때 _getche 함수를 두 번 호출해야 합니다. 첫 번째 호출은 0 또는 0xE0 반환하고 두 번째 호출은 실제 키 코드를 반환합니다.

이러한 함수는 호출 스레드를 잠그므로 스레드로부터 안전합니다. 비 잠금 버전은 다음_getwche_nolock을 참조하세요_getche_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

참고 항목

콘솔 및 포트 I/O
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock