vsnprintf_s、_vsnprintf_s、_vsnprintf_s_l、_vsnwprintf_s、_vsnwprintf_s_l

使用指向参数列表的指针写入格式化输出。 这些函数是 、 _vsnwprintf_vsnprintf_vsnprintf_l的版本vsnprintf，_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.

在调试版本中，终止NULL后的剩余sizeOfBuffer字节用“xFE”填充，如 _CrtSetDebugFillThreshold中所述。

这些带有 _l 后缀的函数的版本是相同的，只是它们使用传入的 locale 参数，而不是当前线程区域设置。

vsnprintf_s 与 ANSI 标准相同 _vsnprintf_s ，并且为了符合 ANSI 标准而包含在内。 _vnsprintf 保留以实现向后兼容性。

行为摘要

对于下表：

• 设 len 为格式化数据的大小。 如果函数占用 char 缓冲区，则大小以字节为单位。 如果函数占用缓冲区 wchar_t ，则 size 指定 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_end、 va_start