0

0

c++如何将结构体写入二进制文件_c++ write函数用法【教程】

尼克

尼克

发布时间:2026-02-02 16:30:09

|

427人浏览过

|

来源于php中文网

原创

只有POD结构体才能用write()直接写入二进制文件,因其需满足无虚函数、无非平凡构造/析构、成员public且均为POD、无可变const或引用等条件;含std::string等非POD成员的结构体必须手动序列化。

c++如何将结构体写入二进制文件_c++ write函数用法【教程】

直接用 write() 写结构体,必须确保结构体是 POD 类型

不是所有 struct 都能直接 write() 到二进制文件。只有满足 POD(Plain Old Data)要求的结构体才安全:不能有虚函数、不能有非平凡构造/析构函数、所有成员必须是 public 且本身也是 POD、不能有引用或非静态 const 成员。

常见踩坑点:

  • 加了 std::stringstd::vector 的结构体——sizeof 不等于实际数据大小,直接 write() 只会写指针地址,读取时崩溃
  • 用了 class 关键字但没写访问控制,默认 private,导致成员不可直接内存拷贝
  • 结构体内有位域(bit-field)或编译器填充(padding),跨平台读写可能不一致

验证方法:运行时检查 std::is_pod_v(C++17 起)或 std::is_trivially_copyable_v(更准确,推荐)。

write() 的参数顺序和长度必须严格匹配 sizeof

std::ofstream::write() 是底层字节写入,它不管语义,只认两个参数:const char* 起始地址 + size_t 字节数。写结构体就是把整个对象内存块“原样 dump”进去。

立即学习C++免费学习笔记(深入)”;

正确写法示例:

struct Point {
    int x;
    float y;
};
Point p{42, 3.14f};
std::ofstream file("data.bin", std::ios::binary);
file.write(reinterpret_cast(&p), sizeof(p));

关键细节:

自由画布
自由画布

百度文库和百度网盘联合开发的AI创作工具类智能体

下载
  • 必须用 reinterpret_cast 转换地址,不能用 static_cast 或 C 风格强转
  • 第二个参数必须是 sizeof(p),不是 sizeof(Point)(虽常等价,但取变量更稳妥)
  • 打开文件时务必加 std::ios::binary,否则 Windows 下会把 \n 错误转成 \r\n

读取时要严格按写入顺序和类型还原,且注意对齐与字节序

写进去的是裸字节,读出来也得用完全相同的结构体定义、相同编译器、相同 ABI 设置(如结构体对齐方式)。否则 read() 后成员值会错乱。

典型问题:

  • 结构体在不同平台或不同编译选项下(如 #pragma pack)内存布局不同,导致读出的 x 实际是 y 的高位字节
  • 跨大端/小端机器传输文件,整数字段值翻转(如 int x = 0x12345678 在小端机写入,大端机读成 0x78563412
  • 忘记检查 file.gcount()file.fail(),写入失败却继续读,得到脏数据

安全读取示例:

Point p_read{};
std::ifstream file("data.bin", std::ios::binary);
file.read(reinterpret_cast(&p_read), sizeof(p_read));
if (!file || file.gcount() != sizeof(p_read)) {
    // 读取不完整或失败
}

非 POD 结构体必须手动序列化,别碰 write()

只要结构体里含 std::stringstd::vectorstd::shared_ptr 等,就放弃直接 write()。它们的内存布局不是连续的,内部指针指向堆区,写进去毫无意义。

替代方案(按复杂度升序):

  • 手写 serialize() / deserialize() 成员函数,逐字段处理:先写字符串长度 uint32_t,再写字符数组;对 vector 先写 size,再循环写每个元素
  • std::memcpy 拷贝到临时 std::vector 缓冲区,再 write() 整个缓冲区(仍需自己管理序列化逻辑)
  • 引入轻量库如 msgpackcereal,它们自动处理类型、版本、容器嵌套,但会增加依赖和运行时开销

最易忽略的一点:即使结构体当前是 POD,一旦后续加了一个 std::string 成员,编译可能仍通过,但运行时数据就全毁了——这种隐式破坏极难调试。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

523

2023.08.02

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

532

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

361

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1505

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

625

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

698

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

650

2024.04.29

AO3官网入口与中文阅读设置 AO3网页版使用与访问
AO3官网入口与中文阅读设置 AO3网页版使用与访问

本专题围绕 Archive of Our Own(AO3)官网入口展开,系统整理 AO3 最新可用官网地址、网页版访问方式、正确打开链接的方法,并详细讲解 AO3 中文界面设置、阅读语言切换及基础使用流程,帮助用户稳定访问 AO3 官网,高效完成中文阅读与作品浏览。

45

2026.02.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 8.3万人学习

Excel 教程
Excel 教程

共162课时 | 15.1万人学习

PHP基础入门课程
PHP基础入门课程

共33课时 | 2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号