简单搞懂 C++ 文件读写：`std::ofstream` 和 `std::ifstream`

文件读写是编程的必备技能。在 C++ 中，用 std::ofstream 写文件，std::ifstream 读文件。

写入文件（std::ofstream）

1）基础写入

#include <fstream>

// 1. 创建并打开文件（默认清空原内容）
std::ofstream fout("data.txt"); // 默认模式：覆盖写入（若文件存在则清空，否则创建）

// 2. 检查是否成功打开
if (!fout.is_open()) { 
    std::cerr << "文件打开失败！";
    return;
}

// 3. 写入内容（文本模式自动处理换行符）
fout << "Hello, 你好！\n";
fout << 42 << " " << 3.14; // 写入数字

// 4. 关闭文件（不写也会自动关闭）
fout.close(); 

2）二进制模式写入

// 写入二进制数据（如结构体）
struct Point { int x, y; };
Point p{10, 20};

std::ofstream binFile("point.bin", std::ios::binary); // 二进制方式
binFile.write(reinterpret_cast<char*>(&p), sizeof(Point));

3）预分配文件空间

// 目标：创建一个 1024 字节的空文件
std::ofstream file("prealloc.bin", std::ios::binary);
file.seekp(1023);    // 移动到第 1023 字节位置（从0开始）
file.put('\0');      // 写入1字节，总大小变为 1024

seekp(N-1) + put('\0') 才能生成准确大小为 N 的文件。

读取文件（std::ifstream）

1）基础读取

#include <fstream>
#include <string>

std::ifstream fin("data.txt"); // 默认只读文本模式
if (!fin) { // 检查是否打开成功
    std::cerr << "文件打开失败！";
    return;
}

// 逐行读取（推荐！）
// 使用 std::string
std::string line;
while (std::getline(fin, line)) {
    std::cout << line << std::endl;
}

// 使用 char[]
char buffer[256];
while (fin.getline(buffer, sizeof(buffer))) {
    std::cout << buffer << std::endl;
}

// 按词读取
std::string word;
while (fin >> word) {  // 以空格为分隔符读取单词
    std::cout << word << " ";
}

// 一次性读取全文
fin.seekg(0, std::ios::end);  // 移动指针到末尾
size_t size = fin.tellg();    // 获取文件大小
fin.seekg(0);                 // 回到文件头
std::string content(size, ' '); //创建与文件大小相同的string对象content，并用空格初始化
fin.read(&content[0], size);  // 读取全部内容到content中

2）二进制模式读取

// 读取结构体
Point p;
std::ifstream binFile("point.bin", std::ios::binary);
binFile.read(reinterpret_cast<char*>(&p), sizeof(Point));

重点注意

1）不要重复打开文件：重复打开文件会清空内容。

2）文本模式 vs 二进制模式：

• 文本模式（默认）：自动转换换行符（如 Windows 的 写 \n → \r\n或 读\r\n→\n）。
• 二进制模式：直接读写原始字节，不转换。
• 适用场景：
  • 文本文件用默认模式。
  • 图片、结构体数据用二进制模式。

3）不要用 eof() 做循环条件：

• eof()（End-Of-File）仅在读取操作尝试越过文件末尾时才会被设置为真。可能导致读取两次末尾数据，第二次读取末尾数据时读取失败，eof() 变为 true，存在重复处理末尾数据的可能。
• getline 的机制：如果读取失败（如到达文件末尾），buffer 不会被修改。

总结

• 写文件：<< 或 write()
• 读文件：>>、getline() 或 read()

常用模式总结表

模式名称	模式标志	行为描述
覆盖写入	std::ios::out	默认模式：文件存在则清空内容，不存在则创建；写入新内容。
追加写入	std::ios::out std::ios::app	写入新内容到文件末尾。
二进制写入	std::ios::out std::ios::binary	以二进制格式写入数据。
只读文本	std::ios::in	仅读取文本文件内容；文件必须存在，否则打开失败。
二进制读取	std::ios::in std::ios::binary	以二进制格式读取数据。

文件指针定位方式总结表

方法签名	基准位置	行为描述
seekg(offset, std::ios::beg)	文件开头	从文件开头绝对定位到 offset 字节处（负数无效）
seekg(offset, std::ios::cur)	当前位置	从当前位置相对移动 offset 字节（正数向前，负数向后）
seekg(offset, std::ios::end)	文件末尾	从文件末尾绝对定位到 offset 字节处（正数无效，一般用负数）
seekg(offset)（单参数形式）	当前位置	等价于 seekg(offset, std::ios::cur)，但只能向前移动
seekp(offset, origin)	同 seekg	写指针定位，行为与 seekg 一致（仅用于 ofstream 或 fstream 的写操作）