_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
  一つ以上の書式指定子。

• ... (optional)
  値を格納するために使用される変数は formatの書式指定子で入力文字列から取得された。

• locale
  使用するロケール。

戻り値

どちらの関数で正常に変換され、代入されたフィールドの数を返します。; 戻り値は読み取り専用で代入されなかったフィールドは含まれません。 戻り値が 0 の場合は、代入されたフィールドがなかったことを示します。 エラーが発生するか、最初の変換前に文字列の終端に達した場合は EOF が返されます。 詳細については、「関数」を参照してください。

input または format が NULL ポインターである場合、または length がゼロ以下の場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続が許可された場合、これらの関数は EOF を返し、errno を EINVAL に設定します。

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

この関数は 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>

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

使用例

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

同等の .NET Framework 関数

使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

scanf 関数の文字幅指定