C/C++ 格式化输出全解析：从 printf 到 std::print 的完整演进

本文系统梳理了C/C++格式化输出的演进路线：C语言以printf为核心，snprintf为安全首选；C++从iostream到std::format与std::print实现类型安全与高性能统一。推荐新项目使用std::format和std::print，旧项目以snprintf为安全底线，彻底弃用危险的sprintf。关键细节包括格式符匹配、返回值判断及避免std::endl性能陷阱

---

一、C 语言格式化输出函数族

1. 标准输出与流输出

printf​ —— 输出到标准输出 stdout

int printf(const char *format, ...);

printf("result: %d\n", value);

fprintf​ —— 输出到任意 FILE *流，是整个 printf 家族中最通用的函数

int fprintf(FILE *stream, const char *format, ...);

fprintf(stdout, "hello\n");          // 等价于 printf
fprintf(stderr, "error: %s\n", msg); // 错误信息，无缓冲立即输出
fprintf(fp, "%d\n", value);           // 写入文件

printf(...)在编译器层面完全等价于 fprintf(stdout, ...)。

dprintf​ —— POSIX 标准，直接输出到文件描述符（file descriptor），比 fprintf更底层

int dprintf(int fd, const char *format, ...);

dprintf(sockfd, "HTTP/1.1 200 OK\r\n");

---

2. 输出到字符串（内存缓冲区）

sprintf​ —— 输出到字符数组，不检查缓冲区边界，极易溢出，严禁在新代码中使用

int sprintf(char *str, const char *format, ...);

snprintf​ —— 指定最大写入字节数，C99 引入，是 C 语言中字符串格式化的最终安全方案

int snprintf(char *str, size_t size, const char *format, ...);

char buf[64];
snprintf(buf, sizeof(buf), "value=%d", value);
// 返回值：本应写入的字符数（不含 \0），可用于判断是否被截断

关键细节：snprintf的返回值是「如果缓冲区足够大，本应写入的字符总数」，因此可以用它来动态计算所需缓冲区大小：

int len = snprintf(NULL, 0, "name=%s, age=%d", name, age);
char *buf = malloc(len + 1);
snprintf(buf, len + 1, "name=%s, age=%d", name, age);

---

3. 可变参数底层接口（v 系列）

当需要封装自己的日志函数时，必须使用 va_list版本：

int vprintf(const char *format, va_list ap);
int vfprintf(FILE *stream, const char *format, va_list ap);
int vsnprintf(char *str, size_t size, const char *format, va_list ap);

典型封装模式：

void log_info(const char *fmt, ...) {
    va_list ap;
    va_start(ap, fmt);
    fprintf(stdout, "[INFO] ");
    vfprintf(stdout, fmt, ap);
    fprintf(stdout, "\n");
    va_end(ap);
}

---

4. 宽字符版本

函数	等价关系
wprintf	fwprintf(stdout, ...)
fwprintf	宽字符版 fprintf
swprintf	宽字符版 snprintf

实际工程中极少使用，Unicode 场景通常直接用 UTF-8 + 普通 printf 族函数处理。

---

二、C++ 格式化输出

1. iostream 体系

C++ 传统输出方式，类型安全，可扩展：

#include <iostream>
std::cout << "value=" << value << std::endl;
std::cerr << "error occurred" << std::endl;  // 无缓冲
std::clog << "log message" << std::endl;      // 有缓冲

缺点：格式控制冗长（需要反复操作 manipulator），性能低于 C 风格，不适合复杂排版。

2. C 标准库兼容（<cstdio>）

C++ 中仍然广泛使用 printf族函数，尤其在性能敏感或格式化复杂的场景：

#include <cstdio>
std::printf("x=%d, f=%.2f\n", x, f);

3. C++20 std::format—— 类型安全的现代格式化

#include <format>
std::string s = std::format("x={}, y={:.2f}", x, y);

特点：

• 编译期格式字符串检查（Clang/GCC 支持）

• 不会缓冲区溢出

• 语法类似 Python f-string

• 返回 std::string，便于后续处理

4. C++23 std::print/ std::println

#include <print>
std::print("x={}\n", x);
std::println("x={}", x);  // 自动追加换行

直接输出到 stdout，性能优于 iostream，是当前 C++ 标准输出的最佳选择。

5. std::format_to—— 输出到任意迭代器

#include <format>
#include <vector>
std::vector<char> buf;
std::format_to(std::back_inserter(buf), "value={}", x);

---

三、全函数对照总表

输出目标	C 语言	C++ 传统	C++ 现代
标准输出	printf	std::cout	std::print
错误输出	fprintf(stderr, ...)	std::cerr	std::print(stderr, ...)*
文件	fprintf(fp, ...)	std::ofstream << ...	—
字符串	snprintf	std::ostringstream	std::format
fd 底层	dprintf	—	—
可变参数封装	vfprintf/ vsnprintf	—	—

*std::print输出到 stdout，C++26 可能扩展为支持 FILE*。

---

四、安全性演进路线

sprintf  →  snprintf  →  std::ostringstream  →  std::format  →  std::print
(危险)      (安全)       (类型安全,慢)           (类型安全,快)    (类型安全,最快)

选型建议：

场景	推荐方案
C 语言项目	snprintf+ vfprintf封装日志
C++11~17 项目	snprintf（兼容性好）或 std::ostringstream
C++20+ 项目	std::format+ std::print
高性能日志库	C++20 以下用 snprintf，C++20 以上用 std::format_to+ 自定义缓冲区
嵌入式 / 内核	snprintf或自己实现轻量格式化

---

五、常见陷阱与细节

1. printf 格式符与参数类型不匹配是未定义行为

long long x = 10;
printf("%d\n", x);   // UB，应该用 %lld

2. snprintf返回值的截断判断

int ret = snprintf(buf, size, fmt, ...);
if (ret < 0 || ret >= size) {
    // 被截断或出错
}

3. std::endlvs '\n'

std::endl会强制刷新缓冲区，在循环中使用会严重拖慢性能，日常输出用 '\n'即可。

4. printf与 iostream混用

两者使用不同的缓冲区，混用可能导致输出顺序异常，必要时用 std::ios::sync_with_stdio(false)关闭同步以提升 iostream 性能。

---

六、总结

C 语言的格式化输出以 fprintf为枢纽，snprintf为字符串格式化的最终答案。C++ 经历了从 iostream 到 std::format再到 std::print的演进，核心驱动力是类型安全和性能。新项目应优先使用 C++20 的 std::format/ std::print，旧项目维护则以 snprintf为安全底线，彻底弃用 sprintf。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/luxili/article/details/166775674