printf、fprintf、dprintf、sprintf、snprintf均是格式化输出
原型如下:
printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf - formatted output conversion
#include <stdio.h>
int printf(const char *format, ...);
int fprintf(FILE *stream, const char *format, ...);
int dprintf(int fd, const char *format, ...);
//Return: 输出字符的数量 if OK, 负数 if output error
int sprintf(char *str, const char *format, ...);
//Return: 存在数组的字符数量 if OK, 负数 if encoding error
int snprintf(char *str, size_t size, const char *format, ...);
//Return: 存在数组的字符数量 if 缓冲区足够大, 负数 if encoding error
printf
:写入标准输出
fprintf
:写入指定的流
dprintf
:写入指定的文件描述符
sprintf
:存入指定的数组buf
内,会自动在结尾追加null
字节。此外,因为sprintf
可能会溢出,所以调用者要确保buf
的尺寸
snprintf
:相对于sprintf
明确指定了尺寸,防止溢出问题。
A conversion(转换) specification has four optional components, shown in square brackets(括号) below:
%[flags][fldwidth][precision][lenmodifier]convtype
这是例如
printf("%d", num);
中%d的转换规范。
接下来展示各个可选组成的含义:
apostrophe:省略号
fladwidth
:可以是非负10进制数或者是asterisk(*)
上图部分内容解析
printf(“hello%n”, &count);
这里的%n
作用并不是输出,而是将%n之前的字符数量保存到count
之中
vprintf、vfprintf、vsprintf、vsnprintf
相对于参数的(…)替换成了va_list ap
#include <stdarg.h>
int vprintf(const char *format, va_list ap);
int vfprintf(FILE *stream, const char *format, va_list ap);
int vdprintf(int fd, const char *restrict format, va_list arg);
//Return: number of characters output if OK, negative value if output error
int vsprintf(char *str, const char *format, va_list ap);
//Returns: number of characters stored in array if OK, negative value if encoding error
int vsnprintf(char *str, size_t size, const char *format, va_list ap);
//Returns: number of characters that would have been stored in array if buffer was large enough, negative value if encoding error
printf类与vpritnf类的区别
多数情况下使用printf() 。只有当你需要自己写一个printf()那样的专有函数的时候才需要vprintf()。比如你写一个自己专门的错误输出函数:
int error(char *fmt, ...)
{
int result;
va_list args;
va_start(args, fmt);
// 一些内容
va_end(args);
return result;
}
应当注意到,你不能转发参数给printf,因为printf是变长参数的,而不是vprintf的单独一个va_list。然而vprintf() 函数, 只取一个合并的va_list 参数, 所以完整的版本是:
int error(char *fmt, ...)
{
int result;
va_list args;
va_start(args, fmt);
fputs("Error: ", stderr);
result = vfprintf(stderr, fmt, args);
va_end(args);
return result;
}