_getche、_getwche

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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

戻り値

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

解説

_getch 関数および _getwch 関数は、コンソールから 1 文字読み取り、エコーします。つまり、文字がコンソールに表示されます。これらの関数はいずれも、Ctrl + C キーの読み出しには使用できません。ファンクションキーまたは方向キーを読み出すときは、各関数を 2 回呼び出す必要があります。最初の呼び出しは、0 または 0xE0 を返し、2 回目の呼び出しは実際のキーコードを返します。

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

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

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_gettche	_getche	_getch	_getwche

必要条件

ルーチン	必須ヘッダー
_getche	<conio.h>
_getwche	<conio.h> または <wchar.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

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

abcdey

Type 'Y' when finished typing keys: Y