次の方法で共有

_snscanf_s、 _snscanf_s_l、 _snwscanf_s、 _snwscanf_s_l

  • [アーティクル]

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

構文

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

パラメーター

input
チェックする入力文字列。

length
input 内のチェックする文字数。

format
1 つまたは複数の書式指定子。

locale
使用するロケール。

argument_list
書式指定文字列に従って割り当てられる省略可能な引数。

戻り値

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

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

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

解説

この関数は sscanf_sに似ていますが、入力文字列から調べる固定文字数を指定できる点が異なります。 詳細については、「sscanf_s、_sscanf_s_l、swscanf_s、_swscanf_s_l」を参照してください。

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

Note

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

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

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

Tchar.h のルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_sntscanf_s _snscanf_s _snscanf_s _snwscanf_s
_sntscanf_s_l _snscanf_s_l _snscanf_s_l _snwscanf_s_l

要件

ルーチンによって返される値 必須ヘッダー
_snscanf_s, _snscanf_s_l <stdio.h>
_snwscanf_s, _snwscanf_s_l <stdio.h> または <wchar.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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

関連項目

scanf 関数の文字幅指定