_snscanf、 _snscanf_l、 _snwscanf、 _snwscanf_l
指定した長さの書式付きデータを文字列から読み出します。 これらの関数のセキュリティを強化したバージョンを使用できます。「_snscanf_s、_snscanf_s_l、_snwscanf_s、_snwscanf_s_l」を参照してください。
構文
int __cdecl _snscanf(
const char * input,
size_t length,
const char * format,
...
);
int __cdecl _snscanf_l(
const char * input,
size_t length,
const char * format,
_locale_t locale,
...
);
int __cdecl _snwscanf(
const wchar_t * input,
size_t length,
const wchar_t * format,
...
);
int __cdecl _snwscanf_l(
const wchar_t * input,
size_t length,
const wchar_t * format,
_locale_t locale,
...
);
パラメーター
input
チェックする入力文字列。
length
input 内のチェックする文字数。
format
1 つまたは複数の書式指定子。
...
書式指定子によって入力文字列から抽出された値を formatに格納するために使用される省略可能な変数。
locale
使用するロケール。
戻り値
これらの関数はどちらも、正常に変換および割り当てられたフィールドの数を返します。戻り値には、読み取られたが割り当てられないフィールドは含まれません。 戻り値が 0 の場合は、代入されたフィールドがなかったことを示します。 エラーが発生するか、最初の変換前に文字列の終端に達した場合は EOF が返されます。 詳細については、sscanfを参照してください。
inputまたはformatがNULL ポインターである場合、またはlengthが 0 以下の場合は、「パラメーター検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は EOF を返し、errno を EINVAL に設定します。
これらのエラー コードおよびその他のエラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。
解説
この関数は sscanfに似ていますが、入力文字列から調べる固定文字数を指定できる点が異なります。 詳細については、sscanfを参照してください。
これらの関数のうち _l サフィックスが付けられたバージョンは、現在のスレッド ロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。
汎用テキスト ルーチンのマップ
| Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
|---|---|---|---|
_sntscanf |
_snscanf |
_snscanf |
_snwscanf |
_sntscanf_l |
_snscanf_l |
_snscanf_l |
_snwscanf_l |
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_snscanf, _snscanf_l |
<stdio.h> |
_snwscanf, _snwscanf_l |
<stdio.h> または <wchar.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// crt_snscanf.c
// compile with: /W3
#include <stdio.h>
int main( )
{
char str1[] = "15 12 14...";
wchar_t str2[] = L"15 12 14...";
char s1[3];
wchar_t s2[3];
int i;
float fp;
i = _snscanf( str1, 6, "%s %f", s1, &fp); // C4996
// Note: _snscanf is deprecated; consider using _snscanf_s instead
printf("_snscanf converted %d fields: ", i);
printf("%s and %f\n", s1, fp);
i = _snwscanf( str2, 6, L"%s %f", s2, &fp); // C4996
// Note: _snwscanf is deprecated; consider using _snwscanf_s instead
wprintf(L"_snwscanf converted %d fields: ", i);
wprintf(L"%s and %f\n", s2, fp);
}
_snscanf converted 2 fields: 15 and 12.000000
_snwscanf converted 2 fields: 15 and 12.000000