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

最新推荐文章于 2025-09-18 15:18:50 发布

原创最新推荐文章于 2025-09-18 15:18:50 发布 · 1.4w 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#printf #格式化 #Linux

Linux API 同时被 2 个专栏收录

49 篇文章

订阅专栏

20 篇文章

订阅专栏

本文详细介绍了C语言中的格式化输出函数，包括printf、fprintf、dprintf、sprintf、snprintf等，解释了各函数的功能、原型及使用场景，并通过实例展示了如何正确使用这些函数避免常见错误。

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:

% [f l a g s] [f l d w i d t h] [p r e c i s i o n] [l e n m o d i f i e r] c o n v t y p e

$\%[flags][fldwidth][precision][lenmodifier]convtype$
这是例如printf("%d", num);中%d的转换规范。
接下来展示各个可选组成的含义：
figure 5-7

apostrophe:省略号

fladwidth:可以是非负10进制数或者是asterisk（*）

figure5-8

figure 5.9

上图部分内容解析

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;
}