标准I/O库 --格式化输出(printf族)

printf族

函数原型

#include <stdio.h>

int printf(const char *restrict format, ...); //输出至标准输出 
int fprintf(FILE *restrict fp, const char *restrict format, ...); //通过文件流输出至文件 
int dprintf(int fd, const char *restrict format, ...); //通过文件描述符输出至文件
int sprintf(char *restrict buf, const char *restrict format, ...); 
											//写入字符串，可能导致缓冲区溢出
int snprintf(char *restrict buf, size_t n, const char *restrict format, ...); 
											//写入n字节(包括'\0')至字符串

返回值
除函数snprintf外, 其余函数成功时返回：输出字符数，
失败时返回：负值。

snprintf()的返回值
成功时返回欲写入的字符数(不包括’\0’)；
失败时返回负值。
通常比较fprintf()的返回值和buf大小，来判断此次写入是否完全。

printf族的变体

函数原型

#include <stdarg.h>
#include <stdio.h>

int vprintf(const char *restrict format, va_list arg);
int vfprintf(FILE *restrict fp, const char *restrict format, va_list arg);
int vdprintf(int fd, const char *restrict format, va_list arg);
int vsprintf(char *restrict buf, const char *restrict format, va_list arg);
int vsnprintf(char *restrict buf, size_t n, const char *restrict format, va_list arg);

printf族的变体与原体类似，仅可变参数表(…)被替换成了va_list类型参数。