C++二进制文件读写详解:原理、代码示例与注意事项

栗子
栗子
发布时间:2026-10-16| 2人浏览过
原创

在C++开发中,当需要高效存储结构化数据或处理非文本媒体(如图文音频)时,二进制文件是理想选择。它保留数据的原始内存布局,避免了字符编码转换的开销。本文将介绍如何使用fopen相关的流式接口(如ofstream和ifstream)进行二进制读写,重点解析结构体序列化与反序列化的完整流程。

C++二进制文件的核心优势

二进制文件由连续的字节序列组成,直接映射内存中的数据值,不受ASCII或UTF-8等字符编码格式的干扰。相较于文本文件,其具有以下显著特点:

  • 高性能:无需将内部数值类型转换为可读字符串,减少了I/O转换计算。
  • 高紧凑性:例如整数100在文本文件中占用3个字节,而在二进制中仅需4个字节(取决于系统位数),且无分隔符冗余,特别适合存储海量记录。
  • 原生兼容性:可直接用于存储图像、声音、视频等二进制媒体数据,以及程序内部定义的复杂对象状态。

准备工作:包含必要的头文件

进行二进制操作前,必须引入标准文件流库:<iostream>用于控制台输出,<fstream>提供文件操作类。此外,建议使用ios::binary标志显式声明以二进制模式打开文件,确保在不同操作系统下行为一致。

第1步:向二进制文件写入数据

写入的核心在于将内存中的特定区域强制转换为字节流并推送到文件缓冲区。以下示例演示了如何将自定义的结构体student及其成员数据保存到student.dat中。

#include <iostream>
#include <fstream>
using namespace std;

int main()
{
    // 定义一个结构体,代表一条学生记录
    struct student {
        int id;             // 学号
        char name[20];      // 姓名
        double score;       // 成绩
    } s1 = {1001, "张三", 90.5}, s2 = {1002, "李四", 80.5};

    // 1. 创建ofstream对象,指定文件名及二进制打开模式
    ofstream fout("student.dat", ios::binary);
    
    // 2. 检查文件是否成功打开
    if (fout) {
        // 3. 写入第一条记录:强制类型转换为char*,长度取sizeof
        fout.write((char*)&s1, sizeof(student));
        
        // 4. 写入第二条记录
        fout.write((char*)&s2, sizeof(student));
        
        // 5. 关闭文件,刷新缓冲区
        fout.close();
        cout << "写入成功!" << endl;
    } else {
        cout << "无法打开文件进行写入!" << endl;
    }
    return 0;
}

操作要点说明:

  • ofstream fout(...):构造函数接收文件路径和标志。ios::binary是关键字,不可省略。
  • write((char*)&s1, ...):第一个参数必须是const char*指针,因此需要使用reinterpret_cast或C风格转换将结构体地址转为字节指针;第二个参数指定要复制的字节数,即结构体的总大小。

第2步:从二进制文件读取数据

读取是写入的逆向过程。由于我们不知道文件中确切有多少条记录,通常采用while(!fin.eof())配合预读取的方式来遍历。这种“先读后判”或“边读边判”的模式能准确提取所有结构化数据。

#include <iostream>
#include <fstream>
using namespace std;

int main()
{
    struct student {
        int id;
        char name[20];
        double score;
    } s;

    // 1. 以二进制模式打开用于读取的文件
    ifstream fin("student.dat", ios::binary);
    
    if (fin) {
        // 2. 首次读取记录
        fin.read((char*)&s, sizeof(student));
        
        // 3. 循环读取直到文件末尾
        while (!fin.eof()) {
            // 打印当前读取到的数据
            cout << "学号:" << s.id 
                 << ",姓名:" << s.name 
                 << ",成绩:" << s.score 
                 << endl;
            
            // 继续读取下一条记录
            fin.read((char*)&s, sizeof(student));
        }
        fin.close();
    } else {
        cout << "无法打开文件进行读取!" << endl;
    }
    return 0;
}

逻辑解析:

上述代码采用了一个经典的do-while变体逻辑。首先执行一次fin.read()加载初始数据进入循环体,然后判断是否到达文件尾。如果未到尾,则处理数据并再次调用read()获取下一条。这种方法简洁地处理了固定长度结构体的批量读取。

技术细节与常见陷阱排查

指针类型转换风险

在使用write和read时,务必确保传入的指针被正确转换为char*。若直接传递结构体引用而未转换,编译器通常会报错,或者导致仅写入/读取了首个字节的错误结果。

跨平台与编译差异

二进制文件具有强依赖性。如果在不同的编译器(如GCC与MSVC)、不同的CPU架构(x86与ARM)或不同的大端/小端机器间交换文件,可能因字节序或填充字节(Padding)不同导致数据乱码。建议在生成可共享的二进制文件时,尽量使用简单的基本类型数组,或在协议层明确定义字节序(如统一使用网络字节序Big-Endian)。

关于std::fstream与旧版stdio的比较

文中代码使用的是现代C++标准的<fstream>面向对象封装。相比传统的stdio.h中的fread()/fwrite(),前者支持更灵活的异常处理和类型安全的流控制,且在资源管理上更易通过RAII机制(作用域结束自动析构)来保证文件关闭。

总结

利用C++的ofstream和ifstream结合ios::binary模式,是实现高效、紧凑数据持久化的有效手段。掌握write()与read()针对内存块的直接操作能力,能够轻松应对数据库转储、游戏存档、日志压缩等多种场景。在实际应用中,请特别注意结构体的内存对齐问题以及跨平台的兼容性校验。

以上就是C++二进制文件读写方式及详细示例的详细内容,更多关于C++文件操作的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。