printf、fprintf、dprintf、sprintf、snprintf、vprintf系列

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 \%[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;
}