前言
C++ 的输入输出建立在「流」(stream)这个概念上:把字节序列从源搬到目的地,源和目的地可以是控制台、文件、内存字符串,甚至自定义设备。std::cin、std::cout 只是这套体系中预定义的两个对象,真正的抽象在 std::basic_istream、std::basic_ostream 和它们背后的 std::basic_streambuf。
典型误解有三个。第一,把 std::cout 当成「类型安全的 printf」,以为 << 只是换了个写法;实际上 operator<< 是重载函数,格式控制靠操纵符(manipulator)和流状态,和格式串是两套模型。第二,以为 std::endl 和 '\n' 完全一样;std::endl 在换行之外还会刷新缓冲区。第三,以为 while (!std::cin.eof()) 是正确的读循环;这个写法会在文件末尾多处理一次旧数据,是教科书级的错误。
本文按「流对象与缓冲—状态与格式—字符串流与文件流—完整示例」展开,代码基准为 C++17。
一、流类层次与缓冲
标准库的流类型大致是这样组织的:
ios_base
└─ basic_ios<charT>
├─ basic_istream<charT> → cin, istringstream, ifstream
└─ basic_ostream<charT> → cout, cerr, clog, ostringstream, ofstream
└─ basic_iostream<charT> → stringstream, fstream<iostream> 提供四个标准对象:
| 对象 | 用途 | 缓冲与绑定 |
|---|
std::cin | 标准输入 | 默认与 std::cout 绑定(tie),读取前会刷新输出 |
std::cout | 标准输出 | 带缓冲,常用 '\n' 或 std::flush 控制刷新 |
std::cerr | 标准错误 | 默认设置 unitbuf,每次输出后刷新,适合错误信息 |
std::clog | 标准日志 | 带缓冲,适合不要求即时可见的日志 |
流本身不直接操作设备,它把读写请求转交给流缓冲区(stream buffer)。缓冲区累积到一定量、遇到刷新、或者流关闭与程序正常退出时才真正写出去。理解这一点,才能解释为什么程序崩溃时最后几行输出可能丢失——数据还在用户态缓冲区里,没有落到终端。
刷新有三种常见触发方式:
std::flush:刷新输出缓冲区。
std::endl:输出'\n'再刷新。
std::cin读取:因为cin与cout绑定,读取前会先刷新cout。
所以循环里写 std::cout << x << std::endl; 会每行刷新一次。是否需要这个代价取决于场景:交互式提示需要即时可见,批量输出则没必要。标准不规定刷新有多贵,但在紧凑循环里它通常是可以避免的开销。
二、流状态与错误处理
每个流都维护一组状态位:
| 状态位 | 含义 | 典型触发 |
|---|
goodbit | 一切正常,值为 0 | 初始状态 |
eofbit | 到达输入末尾 | getline 读到文件尾 |
failbit | 某个操作失败,流仍可用 | 把 "abc" 读进 int |
badbit | 底层 I/O 错误,流可能不可用 | 设备故障、缓冲区异常 |
查询用 good()、eof()、fail()、bad(),重置用 clear()。C++11 起流对象有显式的 operator bool,所以 if (std::cin >> x) 是标准写法:它等价于 if (!std::cin.fail())。
一个常见的死循环:
// 适用于 C++17
int x = 0;
while (std::cin >> x) {
// 处理 x
}如果用户输入了字母,operator>> 失败,failbit 被置位,x 保持不变。循环退出后如果想继续读,必须先 clear() 清除状态,再把坏输入从缓冲区里丢掉:
// 适用于 C++17
#include <iostream>
#include <limits>
void recover() {
std::cin.clear(); // 清除 failbit
std::cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');
}ignore 的第一个参数是「最多忽略多少个字符」,用 numeric_limits<streamsize>::max() 表示不设上限,第二个参数是终止字符。只 clear() 不 ignore(),下一次读取还会撞上同一个坏字符,形成死循环。
eofbit 有一个容易误解的点:它表示「上一次读取碰到了文件尾」,而不是「已经读完」。因此用 eof() 作为循环条件通常晚了一步。正确的按行读取是:
// 适用于 C++17
#include <iostream>
#include <string>
std::string line;
while (std::getline(std::cin, line)) {
// 处理 line
}getline 返回流引用,流在成功时转换为 true。文件末尾时它设置 eofbit 和 failbit,循环退出,不会多处理一行。
三、格式化输出与字符串流
<iomanip> 里的操纵符用于控制格式。它们大致分两类:持久的(改变流状态,影响后续所有输出)和一次性的(只影响下一次输出)。
| 操纵符 | 作用 | 是否持久 |
|---|
std::setw(n) | 设置下一次输出的最小宽度 | 一次性 |
std::setfill(c) | 设置填充字符 | 持久 |
std::setprecision(n) | 设置浮点精度 | 持久 |
std::fixed / std::scientific | 固定小数 / 科学计数 | 持久 |
std::left / std::right | 对齐方式 | 持久 |
std::hex / std::dec / std::oct | 整数进制 | 持久 |
std::boolalpha | 布尔输出为 true/false | 持久 |
std::showpos | 正数显示加号 | 持久 |
std::setw 的一次性是最容易踩的:它只对紧接着的那一个输出项生效,第二次输出就恢复默认。
// 适用于 C++17
#include <iomanip>
#include <iostream>
void table() {
std::cout << std::left << std::setw(10) << "name"
<< std::right << std::setw(6) << "score" << '\n';
std::cout << std::left << std::setw(10) << "alice"
<< std::right << std::setw(6) << 95 << '\n';
}浮点输出要区分「有效数字」和「小数位数」:默认的 setprecision(n) 表示有效数字;加上 std::fixed 后表示小数点后的位数。std::setprecision 影响的是整个流,直到再次修改,写库函数时要注意不要意外改变调用方传入流的格式。
如果需要保存和恢复格式,用 std::ios_base::fmtflags:
// 适用于 C++17
std::ios_base::fmtflags old = std::cout.flags();
std::streamsize oldPrecision = std::cout.precision();
// ... 修改格式并输出 ...
std::cout.flags(old);
std::cout.precision(oldPrecision);C++20 引入了 std::format,提供类似 Python 的格式串,但它是独立于 iostream 的另一套设施;两者可以配合使用,不能假定所有编译器都已完整支持,使用前请查工具链的支持表。
字符串流
std::istringstream、std::ostringstream、std::stringstream 把字符串当成流来读写,非常适合「解析一行文本」和「拼接格式化结果」。
// 适用于 C++17
#include <sstream>
#include <string>
void parse_line(const std::string& line) {
std::istringstream iss(line);
std::string key;
int value = 0;
if (iss >> key >> value) {
// 解析成功
} else {
// 格式不符合预期
}
}stringstream 的 str() 有两个重载:无参版本返回当前内容的副本,带参版本替换内容。注意 str() 返回的是 std::string 值,不是引用;想持续追加,应在流对象上继续 <<,最后再取一次。
清空 stringstream 不能只调用 str(""),还要 clear():
// 适用于 C++17
std::stringstream ss;
ss << "first";
ss.str(""); // 清空内容
ss.clear(); // 清除 eofbit/failbit 等状态
ss << "second";只清内容不清状态,如果之前读到过末尾,后续读写可能直接失败。
四、文件流与二进制 I/O
文件流在构造时打开文件,析构时自动关闭,天然符合 RAII。打开失败不会抛异常(除非显式开启异常掩码),要检查 is_open() 或流对象本身:
// 适用于 C++17
#include <fstream>
#include <string>
void read_all(const std::string& path) {
std::ifstream in(path); // 默认 ios::in
if (!in.is_open()) {
return; // 打开失败
}
std::string line;
while (std::getline(in, line)) {
// 处理每一行
}
} // in 析构时关闭文件打开模式用 std::ios::openmode 位掩码组合:
| 模式 | 含义 |
|---|
std::ios::in | 读 |
std::ios::out | 写,默认会截断已有文件 |
std::ios::app | 追加,每次写之前定位到末尾 |
std::ios::trunc | 截断 |
std::ios::ate | 打开后定位到末尾,但写入位置可改变 |
std::ios::binary | 二进制模式,不做换行转换 |
Windows 上文本模式会把 \n 写成 \r\n,读取时再转换回来;二进制模式不做这个转换。读写二进制数据(图片、结构体内存映像)必须加 std::ios::binary,否则字节数会变化,校验和、文件长度都会对不上。这个转换属于平台相关的文本模式行为,不同系统可能不同。
二进制读写用 read / write:
// 适用于 C++17
#include <fstream>
#include <vector>
bool read_block(const std::string& path, std::vector<char>& out,
std::streamsize n) {
std::ifstream in(path, std::ios::binary);
if (!in) {
return false;
}
out.resize(static_cast<std::size_t>(n));
in.read(out.data(), n);
// read 可能只读到一部分,gcount 返回实际字节数
out.resize(static_cast<std::size_t>(in.gcount()));
return in.good() || in.eof();
}read 在读完请求的字节数之前遇到文件尾时,会设置 eofbit 和 failbit,但已经读到的数据仍在缓冲区里,gcount() 告诉你实际读了多少。不要把 read 当成「一定读满」。
定位用 seekg / tellg(输入)和 seekp / tellp(输出)。对文本流使用绝对定位时,tellg 的返回值只适合原样传回 seekg,不要拿它当字符偏移做算术。二进制流才可以按字节精确定位。
完整示例:读取、解析并输出报表
下面把按行读取、字符串流解析、格式化输出串起来。它读取一个每行「名字 分数」的文本文件,跳过格式不合法的行,再输出对齐的报表。
// 适用于 C++17
#include <fstream>
#include <iomanip>
#include <iostream>
#include <sstream>
#include <string>
#include <vector>
struct Record {
std::string name;
int score = 0;
};
int main() {
std::ifstream in("scores.txt");
if (!in) {
std::cerr << "无法打开 scores.txt\n";
return 1;
}
std::vector<Record> records;
std::string line;
while (std::getline(in, line)) {
if (line.empty()) {
continue;
}
std::istringstream iss(line);
Record record;
if (iss >> record.name >> record.score) {
records.push_back(record);
} else {
std::cerr << "跳过无法解析的行: " << line << '\n';
}
}
std::ofstream out("report.txt"); // 默认 ios::out,会截断
if (!out) {
std::cerr << "无法写入 report.txt\n";
return 1;
}
out << std::left << std::setw(12) << "NAME"
<< std::right << std::setw(8) << "SCORE" << '\n';
for (const Record& record : records) {
out << std::left << std::setw(12) << record.name
<< std::right << std::setw(8) << record.score << '\n';
}
std::cout << "共处理 " << records.size() << " 条记录\n";
return 0;
}几个检查点:std::getline 会丢弃行尾的 \n,但保留 \r(如果文件是 CRLF 且以文本模式打开,\r 通常会被转换掉;二进制模式则不会)。iss >> record.name >> record.score 成功才入表,失败的行只报告不中断。std::setw 每次输出都要重新设置,所以循环里重复写。std::left 和 std::right 是持久的,交替使用时要显式切换。
常见坑点
- ❌
while (!std::cin.eof()) { std::getline(std::cin, line); ... }
✅ 用 while (std::getline(std::cin, line));eof() 在读取失败后才置位,前者会多处理一次旧内容。
- ❌ 先
std::cin >> x,紧接着std::getline(std::cin, line),发现读到空串。
✅ >> 留下换行符;先 std::cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n'),再 getline。
- ❌ 在紧凑循环里用
std::endl输出每一行。
✅ 不需要立即刷新时用 '\n';交互提示再考虑 std::endl 或 std::flush。
- ❌ 以为
std::setw会一直生效,后面的列都按同样宽度对齐。
✅ setw 只影响下一次输出;每一项都要重新设置。
- ❌ 读取失败后只
std::cin.clear()就继续,结果无限循环。
✅ 清状态后还要丢弃缓冲区里的坏字符,clear() 加 ignore() 一起用。
- ❌ Windows 上读写二进制文件不加
std::ios::binary,发现字节数变多。
✅ 二进制数据一律用 in | std::ios::binary / out | std::ios::binary,文本转换只在文本模式发生。
- ❌ 认为
read(buf, n)一定读满n字节。
✅ 用 gcount() 取实际读取量;文件尾可能只读到一部分。
- ❌
std::ios::sync_with_stdio(false); std::cin.tie(nullptr);之后又混用printf/scanf与cin/cout。
✅ 关闭同步后两套缓冲互不感知,要么全程用 iostream,要么不要关闭同步。
总结
| 主题 | 关键 API | 注意事项 |
|---|
| 标准流 | cin、cout、cerr、clog | cerr 每次输出后刷新,cout 带缓冲 |
| 状态 | good/fail/eof/bad、clear、ignore | 失败后先清状态再清缓冲 |
| 格式化 | setw、setprecision、fixed、left | setw 一次性,其余多数持久 |
| 字符串流 | istringstream、ostringstream | 复用前 str("") 加 clear() |
| 文件流 | ifstream、ofstream、fstream | 析构自动关闭,二进制加 binary |
| 二进制读写 | read、write、gcount | 不保证读满,按实际计数处理 |
C++ 的 IO 流不是「语法更啰嗦的 printf」,而是一套带状态、带缓冲、可扩展的抽象。写业务代码时,只要抓住三点:用流对象本身做条件判断、格式化操纵符注意作用范围、二进制与文本模式不要混。把这三点变成习惯,eof 多读一行、setw 失效、文件长度对不上这类问题基本可以避免。
本文系统讲解C++标准IO流的核心机制,涵盖流类层次结构与缓冲原理、流状态位(failbit/eofbit/badbit)及正确错误处理方式、格式化操纵符的作用域与浮点输出控制、字符串流(stringstream)的正确清空与使用、文件流RAII管理及二进制I/O关键要点(如ios::binary必要性、read/write实际字节数判断)。强调常见误区,如while(!eof())误用、setprecision作用范围、同步关闭风险等,基于C++17标准。
419

被折叠的 条评论
为什么被折叠?



