_cscanf、_cscanf_l、_cwscanf、_cwscanf_l
reads コンソールからのデータの書式設定。これらの関数のセキュリティを強化したバージョンについては、「_cscanf_s、_cscanf_s_l、_cwscanf_s、_cwscanf_s_l」を参照してください。
重要 |
---|
この API は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。 |
int _cscanf(
const char *format [,
argument] ...
);
int _cscanf_l(
const char *format,
locale_t locale [,
argument] ...
);
int _cwscanf(
const wchar_t *format [,
argument] ...
);
int _cwscanf_l(
const wchar_t *format,
locale_t locale [,
argument] ...
);
パラメーター
format
書式指定文字列。argument
省略可能なパラメーター。locale
使用するロケール。
戻り値
正常に変換され、再配置フィールドの数。戻り値には、再配置フィールドは含まれません。戻り値は、ファイルの終端で読み取りの EOF です。これは、キーボード入力がオペレーティング システムのコマンド ラインのレベルでリダイレクトする場合に発生します。戻り値 0 は、フィールドが再配置ことを意味します。
解説
_cscanf 関数は argumentで指定された位置にコンソールから直接データを読み込みます。_getche 関数は文字を読み取るために使用されます。各省略可能なパラメーターは formatの型指定子に対応する型の変数へのポインターである必要があります。入力の解釈は scanf の関数の format のパラメーターと同じ形式と機能がフィールドは、あるフォーム コントロール。_cscanf は、通常、入力文字がエコーされますが、最後のが _ungetchにある場合は記述しません。
この関数は、パラメーターを検証します。ファイル形式が null の場合、無効なパラメーター ハンドラーが パラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、errno が EINVAL に設定され、関数から EOF が返されます。
これらの関数のうち _l サフィックスが付けられたバージョンは、現在のスレッド ロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcscanf |
_cscanf |
_cscanf |
_cwscanf |
_tcscanf_l |
_cscanf_l |
_cscanf_l |
_cwscanf_l |
必要条件
ルーチン |
必須ヘッダー |
---|---|
_cscanf,_cscanf_l |
<conio.h> |
_cwscanf, _cwscanf_l |
<conio.h> か <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_cscanf.c
// compile with: /c /W3
/* This program prompts for a string
* and uses _cscanf to read in the response.
* Then _cscanf returns the number of items
* matched, and the program displays that number.
*/
#include <stdio.h>
#include <conio.h>
int main( void )
{
int result, i[3];
_cprintf_s( "Enter three integers: ");
result = _cscanf( "%i %i %i", &i[0], &i[1], &i[2] ); // C4996
// Note: _cscanf is deprecated; consider using _cscanf_s instead
_cprintf_s( "\r\nYou entered " );
while( result-- )
_cprintf_s( "%i ", i[result] );
_cprintf_s( "\r\n" );
}
入力
1 2 3
出力
Enter three integers: 1 2 3
You entered 3 2 1
参照
関連項目
_cprintf、_cprintf_l、_cwprintf、_cwprintf_l
fscanf、_fscanf_l、fwscanf、_fwscanf_l