vsscanf_s, vswscanf_s

從字串讀取格式化的資料。 這些版本的 vsscanf 具有 vswscanf 安全性增強功能，如 CRT 中的安全性功能中所述 。

語法

int vsscanf_s(
   const char *buffer,
   const char *format,
   va_list argptr
);
int vswscanf_s(
   const wchar_t *buffer,
   const wchar_t *format,
   va_list arglist
);

參數

buffer
已儲存資料

format
格式控制字串。 如需詳細資訊，請參閱 格式化規格欄位： scanf 和 wscanf 函式 。

arglist
變數引數清單。

傳回值

每個函式都會傳回成功轉換並指派的欄位數目。 傳回值不包含已讀取但未指派的欄位。 傳回值 0 表示未指派任何欄位。 傳回值是 EOF，其表示發生錯誤或在進行第一次轉換之前就到達字串結尾。

如果 buffer 或 format 為 NULL 指標，則會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，這些函式會傳回 -1，並將 errno 設為 EINVAL。

如需這些錯誤碼和其他錯誤碼的相關資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

vsscanf_s 函式會將 buffer 的資料讀入 arglist 引數清單各引數所指定的位置。 引數清單中的引數指定變數的指標，而變數的類型對應至 format 中的類型指定名稱。 不同于較不安全的版本 vsscanf ，當您使用以 [] 括住 的型別字段字元 c 、C 、 s、 S 或字串控制集時，需要緩衝區大小參數。 字元中的緩衝區大小必須緊接在每個需要它的緩衝區參數之後，以另一個參數的形式提供。

緩衝區大小包含結束的 null。 寬度規格欄位可以用來確保讀入的 Token 可納入緩衝區。 如果未使用寬度規格欄位，而且讀取中的標記太大而無法放入緩衝區中，則不會寫入該緩衝區。

如需詳細資訊，請參閱 scanf_s 、 _scanf_s_lwscanf_s 和 _wscanf_s_l scanf 類型欄位字元。

注意

大小參數為型別 unsigned，而非 size_t。

format 引數會控制輸入欄位的解譯，而且形式和功能與 scanf_s 函式的 format 引數相同。 如果在重疊的字串之間進行複製，則行為是未定義的。

vswscanf_s 是 vsscanf_s的寬字元版本； vswscanf_s 的引數是寬字元字串。 vsscanf_s 不會處理多位元組十六進位字元。 vswscanf_s 不會處理 Unicode 全形十六進位或「相容性區域」字元。 否則 vswscanf_s 和 vsscanf_s 的行為相同。

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_vstscanf_s	vsscanf_s	vsscanf_s	vswscanf_s

需求

常式	必要的標頭
vsscanf_s	<stdio.h>
vswscanf_s	<stdio.h > 或 < wchar.h>

如需相容性詳細資訊，請參閱相容性。

範例

// crt_vsscanf_s.c
// compile with: /W3
// This program uses vsscanf_s to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>
#include <stdarg.h>
#include <stdlib.h>

int call_vsscanf_s(char *tokenstring, char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vsscanf_s(tokenstring, format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    char  tokenstring[] = "15 12 14...";
    char  s[81];
    char  c;
    int   i;
    float fp;

    // Input various data from tokenstring:
    // max 80 character string:
    call_vsscanf_s(tokenstring, "%80s", s, _countof(s));
    call_vsscanf_s(tokenstring, "%c", &c, sizeof(char));
    call_vsscanf_s(tokenstring, "%d", &i);
    call_vsscanf_s(tokenstring, "%f", &fp);

    // Output the data read
    printf("String    = %s\n", s);
    printf("Character = %c\n", c);
    printf("Integer:  = %d\n", i);
    printf("Real:     = %f\n", fp);
}

String    = 15
Character = 1
Integer:  = 15
Real:     = 15.000000

另請參閱

資料流 I/O
scanf, _scanf_l, wscanf, _wscanf_l
sscanf, _sscanf_l, swscanf, _swscanf_l
sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vsscanf, vswscanf