_snscanf_s、_snscanf_s_l、_snwscanf_s、_snwscanf_s_l

更新 : 2007 年 11 月

指定した長さの書式付きデータを文字列から読み取ります。これらの関数は、「CRT のセキュリティ強化」に説明されているように、_snscanf、_snscanf_l、_snwscanf、_snwscanf_l のセキュリティが強化されたバージョンです。

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   locale_t locale,
   ...
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   locale_t locale,
   …
);

パラメータ

• input
  確認する入力文字列。

• length
  input で確認する文字数。

• format
  1 つ以上の書式指定子。

• ... (optional)
  format の書式指定子による入力文字列からの抽出値を格納する際に使用される変数。

• locale
  使用するロケール。

戻り値

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

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

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

解説

この関数は、入力文字列から確認する固定文字数を指定できる点を除いて、sscanf_s 関数と同様です。詳細については、「sscanf_s、_sscanf_s_l、swscanf_s、_swscanf_s_l」を参照してください。

型フィールドの文字 c、C、s、S、[ を指定したバッファ サイズのパラメータが必要です。詳細については、「scanf 関数の型フィールド文字」を参照してください。

メモ :
サイズ パラメータは size_t 型ではなく、unsigned 型です。

_l サフィックスが付いているこれらの関数の各バージョンは、現在のスレッド ロケールの代わりに渡されたロケール パラメータを使用する点を除いて同じです。

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

必要条件

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

使用例

// crt_snscanf_s.c
// This example scans a string of 
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#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_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

.NET Framework の相当するアイテム

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

参照

参照

scanf 関数の文字幅指定