_getche_nolock、_getwche_nolock

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

更新 : 2007 年 11 月

スレッドをロックすることなく、エコーを使用してコンソールから文字列を取得します。

int _getche_nolock( void );
wint_t _getwche_nolock( void );

戻り値

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

解説

_getche_nolock と _getwche_nolock は、他のスレッドからの干渉から保護されない点を除いて _getche および _getwche と同じです。スレッドをロックアウトするオーバーヘッドがないため、この方が処理が早くなります。これらの関数は、シングルスレッドアプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッドセーフなコンテキストだけで使用します。

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

Tchar.h のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_gettche_nolock	_getche_nolock	_getch_nolock	_getwche_nolock

必要条件

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

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

使用例

// crt_getche_nolock.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_nolock();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch_nolock( ch );
   _putch_nolock( '\r' );    // Carriage return
   _putch_nolock( '\n' );    // Line feed 
}

abcdey

Type 'Y' when finished typing keys: Y