vwprintf, vfwprintf, vswprintf, vwprintf_s, vfwprintf_s, vswprintf_s, vsnwprintf_s
定义于头文件 <wchar.h>
|
||
(1) | ||
int vwprintf( const wchar_t *format, va_list vlist ); |
(C95 起) (C99 前) |
|
int vwprintf( const wchar_t *restrict format, va_list vlist ); |
(C99 起) | |
(2) | ||
int vfwprintf( FILE* stream, const wchar_t *format, va_list vlist ); |
(C95 起) (C99 前) |
|
int vfwprintf( FILE *restrict stream, const wchar_t *restrict format, va_list vlist ); |
(C99 起) | |
(3) | ||
int vswprintf( wchar_t *buffer, size_t bufsz, const wchar_t *format, va_list vlist ); |
(C95 起) (C99 前) |
|
int vswprintf( wchar_t *restrict buffer, size_t bufsz, const wchar_t *restrict format, va_list vlist ); |
(C99 起) | |
int vwprintf_s( const wchar_t *restrict format, va_list vlist); |
(4) | (C11 起) |
int vfwprintf_s( FILE * restrict stream, const wchar_t *restrict format, va_list vlist); |
(5) | (C11 起) |
int vswprintf_s( wchar_t *restrict buffer, rsize_t bufsz, const wchar_t * restrict format, va_list vlist); |
(6) | (C11 起) |
int vsnwprintf_s( wchar_t *restrict buffer, rsize_t bufsz, const wchar_t *restrict format, va_list vlist); |
(7) | (C11 起) |
从vlist
所定义的位置加载数据,将它们转换成宽字符串等价物,并将结果写入各种池。
stream
。buffer
。至多写入后随空宽字符的 size-1 个宽字符。产生的宽字符串将以空宽字符终止,除非 bufsz
为零。-
format
中存在转换指定符%n
- 任何一个对应
%s
的参数是空指针 -
format
或buffer
是空指针 -
bufsz
为零或大于 RSIZE_MAX - 在任何一个字符串及字符转换指定符中出现编码错误
- (仅对于
vswprintf_s
)要存储于buffer
(含尾随宽空字符)的宽字符串长度会超出bufsz
-
- 同所有边界检查函数,
vwprintf_s, vfwprintf_s, vswprintf_s, vsnwprintf_s
仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含<wchar.h>
前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
stream | - | 要写入的输出宽流 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
buffer | - | 指向要写入的宽字符串的指针 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bufsz | - | 写入的最大宽字符数(含空终止宽字符) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | - | 指向指定数据转译方式的空终止宽字符串的指针。
格式字符串由普通宽字符(除了
下列格式指定符可用:
浮点转换函数转换无穷大到 非数转换成 转换 尽管 定宽整数类型( int8_t 等)的正确转换指定定义于头文件 <inttypes.h> (尽管 PRIdMAX 、 PRIuMAX 等就是 内存写入转换指定符 %n 是安全漏洞的常见目标,这里格式字符串依赖用户输入,而有边界检查的 在每个转换指定符的行动后有一个序列点;这允许于同一变量多次存入 %n 的结果,并在同一此调用中打印出先前以 %n 存储的值。 若转换指定非法,则行为未定义。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
vlist | - | 含有待打印数据的可变参数列表 |
返回值
bufsz
限制被截断,则函数返回假如未强加限制则本应写入的字符数(不含空终止宽字符)。buffer
的宽字符数,不计空宽字符(只要 buffer
非空指针且 bufsz
非零且不大于 RSIZE_MAX/sizeof(wchar_t)
,就写入它),或在运行时制约违规时为零,或在编码错误时为负值。bufsz
则本应写入 buffer
的宽字符数,不计空宽字符(只要 buffer
不是空指针且 bufsz
非零且不大于 RSIZE_MAX/sizeof(wchar_t)
,就写入它),或若运行时制约违规或编码错误发生则为负值。注意
所有这些函数调用 va_arg 至少一次,在返回后 vlist
的值不确定。这些函数不调用 va_end ,而必须由调用方进行。
窄字符串提供 vsnprintf ,使得可以确定需求的缓冲区大小可行。不过宽字符串无等价版本( C11 的 vsnwprintf_s 前),而为确定缓冲区大小,程序可能需要调用 vswprintf
,检查返回值,并重分配更大的缓冲区,反复尝试直至成功。
不同于 vswprintf_s
, vsnwprintf_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
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.29.2.5 The vfwprintf function (p: 417-418)
- 7.29.2.7 The vswprintf function (p: 419)
- 7.29.2.9 The vwprintf function (p: 420)
- K.3.9.1.6 The vfwprintf_s function (p: 632)
- K.3.9.1.8 The vsnwprintf_s function (p: 633-634)
- K.3.9.1.9 The vswprintf_s function (p: 634-635)
- K.3.9.1.11 The vwprintf_s function (p: 636)
- C99 standard (ISO/IEC 9899:1999):
- 7.24.2.5 The vfwprintf function (p: 363)
- 7.24.2.7 The vswprintf function (p: 364)
- 7.24.2.9 The vwprintf function (p: 365)
参阅
(C99)(C11)(C11)(C11)(C11) |
打印格式化输出到stdout、文件流或缓冲区 使用可变参数列表 (函数) |
(C95)(C95)(C95)(C11)(C11)(C11)(C11) |
打印格式化宽字符输出到 stdout 、文件流或缓冲区 (函数) |