_getche、_getwche
エコーを持つコンソールから文字を取得します。
.gif "重要 :") 重要 |
|---|
この API は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
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> |
互換性の詳細については、「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
}
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。