如何用c++读取二进制文件 ifstream和fwrite/fread的使用【文件IO】

C++读取二进制文件须用std::ifstream以std::ios::binary模式打开,禁用>>/getline等格式化操作,仅用read()和gcount()成块读取原始字节;不可混用fread/fwrite与C++流。

用 C++ 读取二进制文件,核心是让 std::ifstream 以二进制模式打开,并禁用格式化处理(如换行符转换、流缓冲区的文本解释)。fwrite/fread 是 C 风格函数,不属于 C++ 标准库的流体系,不推荐与 std::ifstream 混用;若要用它们,应搭配 FILE*(即 fopen),而非 C++ 流对象。

用 std::ifstream 正确读二进制文件

关键点:必须指定 std::ios::binary 模式,且避免使用 >>getline() 等面向字符/字符串的提取操作——它们会触发格式化解析,破坏原始字节。

  • read() 成块读取原始字节,传入 char* 缓冲区和字节数
  • gcount() 获取实际读取字节数(可能少于请求值,尤其到文件末尾)
  • 确保缓冲区足够大,或循环读取直到 eof()fail()

示例:

std::ifstream file("data.bin", std::ios::binary);
if (!file.is_open()) { /* 处理错误 */ }

std::vector buffer(1024); while (file.read(buffer.data(), buffer.size())) { size_t n = file.gcount(); // 实际读到的字节数 process_bytes(buffer.data(), n); } // 处理最后一次不足整块的情况 if (file.gcount() > 0) { size_t n = file.gcount(); process_bytes(buffer.data(), n); }

避免混用 ifstream 和 fread/fwrite

std::ifstreamFILE* 使用不同的底层缓冲机制和文件位置指针。强行把 ifstream 的句柄传给 fread(例如通过 rdbuf()->fd())是非标准、不可移植、极易出错的行为。C++ 标准不保证这种互操作性。

  • 如果坚持用 fread/fwrite,请统一用 C 风格:FILE* fp = fopen("data.bin", "rb")
  • 如果用 C++ 流,请全程用 std::ifstream/std::ofstream + read()/write()
  • 二者不要交叉调用,比如不能对同一个文件既用 file.read() 又用 fread(fp, ...)

写二进制文件:用 ofstream.write()

对应读取,写入也需二进制模式,用 write() 直接输出内存块:

  • 打开时加 std::ios::binary
  • write(const char*, size_t) 第二个参数是字节数,不是元素个数
  • 注意:写入 intstruct 等非 char 类型时,要强制转为 const char* 并乘以 sizeof

示例:

int value = 0x12345678;
std::ofstream out("out.bin", std::ios::binary);
out.write(reinterpret_cast(&value), sizeof(value));

注意事项与常见坑

二进制 IO 容易因平台差异出问题,务必注意:

  • 结构体写入前考虑字节对齐和填充(用 #pragma pack(1)std::memcpy 序列化字段)
  • 整数大小端(endianness):跨平台时需手动转换(如 htons/htonl
  • 浮点数二进制表示虽标准(IEEE 754),但不同编译器/平台对 long double 处理可能不同
  • 总是检查 fail()bad() 而不仅是 eof(),IO 错误可能发生在中途