vsnprintf_s、_vsnprintf_s、_vsnprintf_s_l、_vsnwprintf_s、_vsnwprintf_s_l

使用指向參數清單的指標寫入格式化輸出。 這些函數是 、 vsnprintf_vsnprintf_vsnprintf_l的版本_vsnwprintf，_vsnwprintf_l具有 CRT 中的安全功能中所述的安全增強功能。

語法

int vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   _locale_t locale,
   va_list argptr
);

int _vsnwprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);

int _vsnwprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

template <size_t size>
int _vsnprintf_s(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr
); // C++ only

template <size_t size>
int _vsnwprintf_s(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr
); // C++ only

參數

buffer
輸出的存儲位置。

sizeOfBuffer
for 輸出的大小 buffer 。 採用的函數的大小（以位元組為單位），採用的函數的char字的大小（以wchar_t為單位）。

count
要寫入的最大字元數，不包括終止字元 NULL。 對於採用的 wchar_t函數，它是要寫入的寬字元數。 或 _TRUNCATE。

format
格式規範。

argptr
指向參數清單的指標。

locale
格式化輸出時要使用的區域設置。

有關更多資訊，請參閱 格式規範。

返回值

寫入的字元數，不包括 terminating NULL，如果發生輸出錯誤，則不包括負值。

如需詳細資訊，請參閱 行為摘要 。

備註

這些函數中的每一個都採用指向參數清單的指標，然後將給定數據的字元格式化並寫入 count 指向的 buffer 記憶體，並附加一個終止 NULL.

在調試版本中，終止sizeOfBuffer后的剩餘NULL位元組用「xFE」填充，如 _CrtSetDebugFillThreshold中所述。

這些帶有 _l 後綴的函數的版本是相同的，只是它們使用傳入的locale參數，而不是當前線程區域設置。

vsnprintf_s 與 ANSI 標準相同 _vsnprintf_s ，並且為了符合 ANSI 標準而包含在內。 _vnsprintf 保留以實現向後相容性。

行為摘要

下表：

• 讓我們 len 成為格式化數據的大小。 如果函式接受 char 緩衝區，大小會以位元組為單位。 如果函式接受 wchar_t 緩衝區，大小會指定16位單字的數目。
• 字元是指 char 採用 char 緩衝區的函式字元，以及 wchar_t 採用 wchar_t 緩衝區之函式的字元。
• 如需無效參數處理程式的詳細資訊，請參閱 參數驗證。

如需這些錯誤碼和其他錯誤碼的相關信息，請參閱_doserrno、 errno_sys_errlist和 _sys_nerr。

在 C++ 中，範本重載簡化了這些函數的使用;重載可以自動推斷緩衝區長度（無需指定 size 參數），並且可以自動將較舊的非安全函數替換為更新的安全函數。 如需詳細資訊，請參閱安全範本多載。

一般文字常式對應

需求

* UNIX V 相容性需要。

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

範例

// crt_vsnprintf_s.cpp
#include <stdio.h>
#include <wtypes.h>

void FormatOutput(LPCSTR formatstring, ...)
{
   int nSize = 0;
   char buff[10];
   memset(buff, 0, sizeof(buff));
   va_list args;
   va_start(args, formatstring);
   nSize = vsnprintf_s( buff, _countof(buff), _TRUNCATE, formatstring, args);
   printf("nSize: %d, buff: %s\n", nSize, buff);
   va_end(args);
}

int main() {
   FormatOutput("%s %s", "Hi", "there");
   FormatOutput("%s %s", "Hi", "there!");
   FormatOutput("%s %s", "Hi", "there!!");
}

nSize: 8, buff: Hi there
nSize: 9, buff: Hi there!
nSize: -1, buff: Hi there!

另請參閱

資料流 I/O
vprintf 函數
fprintf、 、 _fprintf_l、 fwprintf_fwprintf_l
printf、 、 _printf_l、 wprintf_wprintf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_l
va_arg、 、 va_copy、 va_endva_start