vwprintf_s

vwprintf, vfwprintf, vswprintf, vwprintf_s, vfwprintf_s, vswprintf_s

在标题中定义
	(1)
int vwprintf( const wchar_t *format, va_list vlist		(since C95) (until C99)
int vwprintf( const wchar_t *restrict format, va_list vlist		(since C99)
	(2)
int vfwprintf( FILE* stream, const wchar_t *format, va_list vlist		(since C95) (until C99)
int vfwprintf( FILE restrict stream, const wchar_t restrict format, va_list vlist		(since C99)
	(3)
int vswprintf( wchar_t buffer, size_t bufsz, const wchar_t format, va_list vlist		(since C95) (until C99)
int vswprintf( wchar_t restrict buffer, size_t bufsz, const wchar_t restrict format, va_list vlist		(since C99)
int vwprintf_s( const wchar_t *restrict format, va_list vlist	(4)	(since C11)
int vfwprintf_s( FILE * restrict stream, const wchar_t *restrict format, va_list vlist	(5)	(since C11)
int vswprintf_s( wchar_t restrict buffer, rsize_t bufsz, const wchar_t restrict format, va_list vlist	(6)	(since C11)
int vsnwprintf_s( wchar_t restrict buffer, rsize_t bufsz, const wchar_t restrict format, va_list vlist	(7)	(since C11)

加载来自定义位置的数据vlist，将它们转换为宽字符串，并将结果写入各种接收器。

1）将结果写入stdout。

2）将结果写入文件流stream。

3）将结果写入一个宽字符串buffer。最bufsz-1宽字符后面跟着空宽字符。生成的宽字符串将以空宽字符结尾，除非bufsz为零。

4-7）与（1-3）相同，只是在运行时检测到以下错误并调用当前安装的约束处理函数：

转换说明符%n存在于format

8）与（7）相同，除了它会截断结果以适应s所指向的数组。由于所有的边界检查功能，vwprintf_s，vfwprintf_s，vswprintf_s，和vsnwprintf_s仅保证可供如果__STDC_LIB_EXT1__由实现所定义，并且如果用户定义__STDC_WANT_LIB_EXT1__的整数常数1，包括之前<wchar.h>。

参数

流	-	输出宽流写入
缓冲	-	指向要写入的宽字符串的指针
bufsz	-	要写入的最大宽字符数
格式	-	指向以空字符结尾的宽字符串的指针，指定如何解释数据。
		格式字符串由普通的宽字符（除外%）组成，它们被不变地复制到输出流和转换规范中。每个转换规范具有以下格式：

		介绍%人物
		（可选）一个或多个修改转换行为的标志：
		-：转换的结果在字段内左对齐（默认情况下它是右对齐的）
		+：带符号转换的符号总是预设为转换结果的前缀（默认情况下结果前面为减号，仅当它为负值时）
		空格：如果签名转换的结果不是以符号字符开头，或者是空的，则空格会预设为结果。如果+标志存在，它将被忽略。
		#：执行转换的替代形式。请参阅下表以了解确切的效果，否则行为未定义。
		0：对于整数和浮点数转换，前导零用于填充字段而不是空格字符。对于整数，如果明确指定了精度，它将被忽略。对于使用此标志的其他转换会导致未定义的行为。如果-标志存在，它将被忽略。
		（可选）整数值或指定最小字段宽度。如果需要，结果会填充空格字符（默认情况下），右侧对齐时填充空白字符，左侧填充右侧填充。在使用的情况下，宽度由类型的附加参数指定int。如果参数的值是负数，则结果是-指定的标志和正的字段宽度。（注意：这是最小宽度：该值从不被截断。）
		（可选） .后面跟随整数或者或者既不指定转换的精度。在使用的情况下，精度由类型的附加参数指定int。如果这个参数的值是负数，它将被忽略。如果既不使用数字也不*使用，则精度取为零。请参阅下表以了解精确度的确切影响。
		（可选）长度修饰符，用于指定参数的大小
		转换格式说明符
		以下格式说明符可用：

		转换
		说明符
		长度修饰符

		%
		c

		s

		d
		i

		o

		x
		X


		u

		f
		F
		e
		E


		a
		A
		（C99）。

		g
		G






		n

		p
		浮点转换函数将无穷大转换为inf或infinity。使用哪一个是实现定义的。

		非数字转换为nan或。使用哪一个是实现定义的。nan(char_sequence)

		该转换F，E，G，A输出INF，INFINITY，NAN来代替。

		即使%c需要int参数，通过char调用可变参数函数时发生的整数提升也是安全的。

		对于固定宽度的字符类型（正确的转换规格int8_t，等等）都在头中定义<inttypes.h>还（虽然PRIdMAX，PRIuMAX等是同义词%jd，%ju等）。

		内存写入转换说明符%n是安全漏洞的常见目标，其中格式字符串取决于用户输入，并且不受边界检查printf_s函数族的支持。

		每个转换说明符的操作之后都有一个序列点 ; 这允许将多个%n结果存储在相同的变量中，或者作为边缘情况，%n在相同的调用中打印由较早修改的字符串。

		如果转换规范无效，则行为未定义。
VLIST	-	包含要打印的数据的变量参数列表

返回值

1-3）如果发生错误，则成功写入宽字符数或写入宽字符数。

4）如果发生错误，则成功写入宽字符数或写入宽字符数。如果由于bufsz限制而导致结果字符串被截断，则函数将返回如果未强加限制，则会写入的字符总数（不包括终止空宽字符）。

5,6）传输到输出流的宽字符数，如果发生输出错误，运行时约束违规错误或编码错误，则输出负值。

7）写入的宽字符数buffer，不包括空宽字符（只要buffer不是空指针，bufsz且不为零且不大于RSIZE_MAX/sizeof(wchar_t)），则为空宽字符，或者在运行时约束违规时为零，并且编码为负值错误

8）不包括终止空字符的宽字符数（只要buffer不是空指针bufsz且不为零且不大于RSIZE_MAX/sizeof(wchar_t)），buffer如果bufsz被忽略，则写入的宽字符数或负值if发生运行时约束违规或编码错误

注意

所有这些函数va_arg至少调用一次，arg返回后的值是不确定的。这些函数不会调用va_end，并且它必须由调用者完成。

虽然窄字符串提供了vsnprintf，这使得可以确定所需的输出缓冲区大小，但对于宽字符串没有等效（直到C11的vsnwprintf_s），并且为了确定缓冲区大小，程序可能需要调用vswprintf，检查结果值，并重新分配一个更大的缓冲区，再次尝试直到成功。

vsnwprintf_s不同vswprintf_s，将截断结果以适应指向的数组buffer，即使截断被大多数边界检查函数视为错误。

例

#include <stdio.h>
#include <time.h>
#include <locale.h>
 
void debug_wlog(const wchar_t *fmt, ...)
{
    struct timespec ts;
    timespec_get(&ts, TIME_UTC
    char time_buf[100];
    size_t rc = strftime(time_buf, sizeof time_buf, "%D %T", gmtime(&ts.tv_sec)
    snprintf(time_buf + rc, sizeof time_buf - rc, ".%06ld UTC", ts.tv_nsec / 1000
 
    va_list args;
    va_start(args, fmt
    wchar_t buf[1000];
    int rc2 = vswprintf(buf, sizeof buf / sizeof *buf, fmt, args
    va_end(args
 
    if(rc2 > 0)
       wprintf(L"%s [debug]: %ls\n", time_buf, buf
    else
       wprintf(L"%s [debug]: (string too long)\n", time_buf
}
 
int main(void)
{
    setlocale(LC_ALL, ""
    debug_wlog(L"Logging, %d, %d, %d", 1, 2, 3
}

可能的输出：

02/20/15 22:12:38.476575 UTC [debug]: Logging, 1, 2, 3