_snscanf_s、 _snscanf_s_l、 _snwscanf_s、 _snwscanf_s_l

讀取的格式字串中的指定長度的資料。 這些是舊版_snscanf、 _snscanf_l、 _snwscanf、 _snwscanf_l中所述的安全性增強功能與安全性功能，則在 CRT 中。

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
  一或多個格式規範。

• ... (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 型別功能變數字元。

注意事項
大小參數屬於型別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>

如需相容性資訊，請參閱相容性在簡介中。

範例

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

.NET Framework 對等用法

不適用。 若要呼叫標準的 c 函式，使用PInvoke。 如需詳細資訊，請參閱平台叫用範例。

請參閱

參考

scanf 寬度規格