vprintf, vfprintf, vsprintf, vsnprintf, vprintf_s, vfprintf_s, vsprintf_s, vsnprintf_s
定义于头文件 <stdio.h>
|
||
(1) | ||
int vprintf( const char *format, va_list vlist ); |
(C99 前) | |
int vprintf( const char *restrict format, va_list vlist ); |
(C99 起) | |
(2) | ||
int vfprintf( FILE *stream, const char *format, va_list vlist ); |
(C99 前) | |
int vfprintf( FILE *restrict stream, const char *restrict format, va_list vlist ); |
(C99 起) | |
(3) | ||
int vsprintf( char *buffer, const char *format, va_list vlist ); |
(C99 前) | |
int vsprintf( char *restrict buffer, const char *restrict format, va_list vlist ); |
(C99 起) | |
int vsnprintf( char *restrict buffer, size_t bufsz, const char *restrict format, va_list vlist ); |
(4) | (C99 起) |
int vprintf_s( const char *restrict format, va_list arg); |
(5) | (C11 起) |
int vfprintf_s( FILE *restrict stream, const char *restrict format, va_list arg); |
(6) | (C11 起) |
int vsprintf_s( char *restrict buffer, rsize_t bufsz, const char *restrict format, va_list arg); |
(7) | (C11 起) |
int vsnprintf_s(char *restrict buffer, rsize_t bufsz, const char *restrict format, va_list arg); |
(8) | (C11 起) |
从 vlist
所定义的位置加载数据,将它们转换成字符串等价物,并将结果写入各种池。
stream
。buffer
。buffer
。至多写入 bufsz
个字符。产生的字符串将以空字符终止,除非 bufsz
为零。若 bufsz
为零,则不写入任何内容,且 buffer
可为空指针,然而照样计算并返回返回值(本应写入的字节数,不包含空终止符)。-
format
中存在转换说明符%n
- 任何一个对应
%s
的参数是空指针 -
format
或buffer
是空指针 -
bufsz
为零或大于 RSIZE_MAX - 任何一个字符串及字符转换说明符中出现编码错误
- (仅对于
vsprintf_s
)存储于buffer
的字符串(包括尾随空字符)长度将超出bufsz
-
- 同所有边界检查函数,
vprintf_s, vfprintf_s, vsprintf_s, vsnprintf_s
仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含<stdio.h>
前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
stream | - | 要写入的输出文件流 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
buffer | - | 指向要写入的字符串的指针 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bufsz | - | 至多可以写入 bufsz - 1 个字符,再加上空终止符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | - | 指向指定数据转译方式的空终止字符串的指针。
格式字符串由普通多字节字符(除了
下列格式指定符可用:
浮点转换函数转换无穷大到 非数转换成 转换 尽管 定宽整数类型( int8_t 等)的正确转换指定定义于头文件 <inttypes.h> (尽管 PRIdMAX 、 PRIuMAX 等就是 内存写入转换指定符 %n 是安全漏洞的常见目标,这里格式字符串依赖用户输入,而有边界检查的 在每个转换指定符的行动后有一个序列点;这允许于同一变量多次存入 %n 的结果,并在同一此调用中打印出先前以 %n 存储的值。 若转换指定非法,则行为未定义。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
vlist | - | 包含要打印数据的变量参数列表 |
返回值
bufsz
限制被截断,函数返回假如未强加限制则本应写入的字符数(不包含空终止字节)。buffer
的字符数,不计空字符(只要 buffer
不是空指针且 bufsz
非零且不大于 RSIZE_MAX
,就会写入它),运行时制约违规时为零,编码错误发生时为负值。buffer
不是空指针且 bufsz
非零且不大于 RSIZE_MAX
,就会写入它)假如忽略 bufsz
则本应写入 buffer
的字符数,或若出现运行时制约违规或编码错误为负值。注解
所有这些函数调用 va_arg 至少一次,返回后 vlist
的值不确定。这些函数不调用 va_end ,而这必须由调用方进行。
不同于 vsprintf_s
, vsnprintf_s
将截断结果以适应 buffer
所指向的数组。
示例
#include <stdio.h> #include <stdarg.h> #include <time.h> void debug_log(const char *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 args1; va_start(args1, fmt); va_list args2; va_copy(args2, args1); char buf[1+vsnprintf(NULL, 0, fmt, args1)]; va_end(args1); vsnprintf(buf, sizeof buf, fmt, args2); va_end(args2); printf("%s [debug]: %s\n", time_buf, buf); } int main(void) { debug_log("Logging, %d, %d, %d", 1, 2, 3); }
可能的输出:
02/20/15 21:58:09.072683 UTC [debug]: Logging, 1, 2, 3
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.21.6.8 The vfprintf function (p: 326-327)
- 7.21.6.10 The vprintf function (p: 328)
- 7.21.6.12 The vsnprintf function (p: 329)
- 7.21.6.13 The vsprintf function (p: 329)
- K.3.5.3.8 The vfprintf_s function (p: 597)
- K.3.5.3.10 The vprintf_s function (p: 598-599)
- K.3.5.3.12 The vsnprintf_s function (p: 600)
- K.3.5.3.13 The vsprintf_s function (p: 601)
- C99 standard (ISO/IEC 9899:1999):
- 7.19.6.8 The vfprintf function (p: 292)
- 7.19.6.10 The vprintf function (p: 293)
- 7.19.6.12 The vsnprintf function (p: 294)
- 7.19.6.13 The vsprintf function (p: 295)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.9.6.7 The vfprintf function
- 4.9.6.8 The vprintf function
- 4.9.6.9 The vsprintf function
参阅
(C95)(C95)(C95)(C11)(C11)(C11)(C11) |
打印格式化宽字符输出到 stdout 、文件流或缓冲区 使用可变参数列表 (函数) |
(C99)(C11)(C11)(C11)(C11) |
打印格式化输出到 stdout 、文件流或缓冲区 (函数) |
(C99)(C99)(C99)(C11)(C11)(C11) |
从 stdin 、文件流或缓冲区读取格式化输入 使用可变参数列表 (函数) |