_getche, _getwche

エコーありでコンソールから文字を取得します。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

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

戻り値

読み取られた文字を返します。 エラーの戻り値はありません。

解説

_getche 関数と _getwche 関数は、エコーありでコンソールから 1 文字を読み取ります。つまり、その文字がコンソールに表示されます。 これらの関数のいずれも Ctrl + C の読み取りに使用することはできません。 _getcheまたは_getwcheが関数キーまたは方向キーを読み取る場合は、関数を 2 回呼び出す必要があります。最初の呼び出しでは 0 または0xE0が返され、2 番目の呼び出しは実際のキー コードを返します。

これらの関数は呼び出し元スレッドをロックするため、スレッド セーフです。 ロックしないバージョンについては、「_getche_nolock、_getwche_nolock」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

Tchar.h のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_gettche	_getche	_getche	_getwche

要件

ルーチンによって返される値	必須ヘッダー
_getche	<conio.h>
_getwche	<conio.h> または <wchar.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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