_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 and _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);
}

.NET Framework 對等用法

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

請參閱

參考

scanf 寬度規格