C / C++ / 系统课时
打开并写入一个文本文件
打开并写入一个文本文件
程序需要保存日志、配置结果或计算数据时,可以用 std::ofstream 把内容写入文本文件。本节从创建输出流开始,完成文件打开检查、数据写入和结果验证,并说明覆盖写入与追加写入的区别。
学习目标
- 使用
std::ofstream创建或打开文本文件并写入内容 - 在写入前检查文件是否成功打开
- 理解默认覆盖写入与
std::ios::app追加写入的差异
用 ofstream 打开输出文件
std::ofstream 定义在 <fstream> 中,专门用于文件输出。创建对象时传入文件名即可尝试打开文件;如果文件不存在,通常会创建新文件。如果文件无法创建或打开,例如目录不存在、权限不足,就会进入失败状态。
打开后应先检查流状态,而不是直接写入。if (!output) 可以判断打开操作是否失败,也能覆盖常见的流错误状态。
写入并关闭文件
下面的程序把三行内容写入当前工作目录下的 notes.txt。这是完整可运行示例,可使用支持 C++17 的编译器编译运行。
#include <fstream>
#include <iostream>
int main() {
std::ofstream output("notes.txt");
// 文件未成功打开时立即停止,避免后续写入被静默丢弃。
if (!output) {
std::cerr << "无法打开 notes.txt\n";
return 1;
}
output << "C++ file output\n";
output << "score = 95\n";
output << "status = passed\n";
// 显式关闭便于在程序继续执行前完成缓冲区刷新。
output.close();
if (!output) {
std::cerr << "写入或关闭文件时发生错误\n";
return 1;
}
std::cout << "文件写入完成\n";
return 0;
}预期输出
文件写入完成同时生成的 notes.txt 预期内容为:
C++ file output
score = 95
status = passed实际文件位置取决于程序运行时的当前工作目录,而不是源代码文件所在目录。
默认写入会覆盖旧内容
以默认方式构造 std::ofstream 时,已有文件通常会被截断,也就是原内容被清空后重新写入。因此,每次运行上面的程序,notes.txt 都只保留本次写入的数据。
如果目标是持续追加日志,可以在打开时使用 std::ios::app。它会让每次写入都发生在文件末尾,而不是覆盖原内容。例如构造形式为 std::ofstream output("notes.txt", std::ios::app)。
是否必须手动 close
std::ofstream 对象离开作用域时,其析构函数会自动关闭文件,所以简单程序并非必须调用 close()。不过,当后续代码需要立即读取该文件,或者希望在继续执行前检查关闭阶段的写入错误时,显式调用 close() 更清楚。
文件输出的基本流程可以固定为:创建输出流、检查打开状态、写入数据、必要时关闭并检查最终状态。只要写文件操作可能失败,就不要仅凭程序没有崩溃来判断写入成功。