C++ 文件操作-写入二进制文件/读取二进制文件

最新推荐文章于 2024-09-26 09:13:29 发布

Qfuuu

最新推荐文章于 2024-09-26 09:13:29 发布

阅读量1.2k

点赞数 23

文章标签： c++ 开发语言

本文链接：https://blog.csdn.net/qq_50373827/article/details/142437827

版权

在 C++ 中，二进制文件的读写操作是非常高效的，特别适合需要存储大量数据、结构化数据或不需要进行文本处理的场景。二进制文件读写比文本文件更高效，因为它直接将数据的内存表示形式写入文件，避免了文本的编码解码。下面详细介绍相关知识点、使用细节，并提供示例。

1. 基本概念

二进制文件：不同于文本文件，二进制文件以数据的原始二进制形式存储，而不是以人类可读的字符编码格式存储。它适用于需要存储非文本数据如图像、声音、结构化数据（如类对象）等。
读写流对象：C++ 使用 std::ifstream 和 std::ofstream 进行文件的读写。二进制模式下，我们使用 std::ios::binary 模式标志。

2. 写入二进制文件

为了将数据写入二进制文件，需要将流设置为二进制模式，并通过 write 函数直接将数据写入文件。write 函数需要传入指向要写入数据的指针及数据的大小。

示例：写入二进制文件

#include <iostream>
#include <fstream>

struct Data {
int id;
double value;
};

int main() {
// 创建一个二进制文件输出流，使用二进制模式
std::ofstream outFile("data.bin", std::ios::binary);

if (!outFile) {
std::cerr << "文件打开失败！" << std::endl;
return 1;
}

// 示例数据
Data data = { 1, 123.456 };

// 写入二进制文件，使用 reinterpret_cast 将数据类型转换为字节
outFile.write(reinterpret_cast<char *>(&data), sizeof(Data));

outFile.close(); // 关闭文件
std::cout << "写入成功！" << std::endl;

return 0;
}

解释：

reinterpret_cast<char*>(&data)：将 Data 类型的指针强制转换为 char*，以字节形式写入文件。
sizeof(Data)：表示需要写入的字节数。

3. 读取二进制文件

读取二进制文件时，需要使用 read 函数，将数据从文件中读取到内存中。read 也是通过传入一个指针来指定存储位置。

示例：读取二进制文件

#include <iostream>
#include <fstream>

struct Data {
int id;
double value;
};

int main() {
// 创建一个二进制文件输入流，使用二进制模式
std::ifstream inFile("data.bin", std::ios::binary);

if (!inFile) {
std::cerr << "文件打开失败！" << std::endl;
return 1;
}

Data data;

// 读取二进制文件内容
inFile.read(reinterpret_cast<char *>(&data), sizeof(Data));

inFile.close(); // 关闭文件

std::cout << "读取成功！ID: " << data.id << " Value: " << data.value << std::endl;

return 0;
}

解释：

read 函数类似于 write，将文件中的字节数据读取到内存中指定的结构体 data 中。
文件必须按同样的顺序和大小写入和读取，否则数据可能会损坏或不一致。

4. 应用场景

结构化数据的存储：如保存配置文件、游戏存档、结构化日志等。
大数据的高效存储：如图像、视频、传感器数据等，通过二进制格式可以减少文件体积。
跨平台数据共享：如果平台的字节序（endianness）一致，二进制文件可以用于不同平台之间的数据传输。

5. 注意事项与常见坑

字节序问题：
- 不同平台（如 Windows 和 Linux）可能使用不同的字节序（大端或小端）。在写入和读取二进制文件时，确保使用一致的字节序。
- 如果需要跨平台传输数据，可以在写入和读取时手动处理字节序，例如使用 htonl 或 ntohl 函数。
结构对齐：
- 结构体内的成员变量可能会因为编译器的对齐方式（padding）导致结构体大小增加，从而影响写入和读取的字节数。
- 可以使用 #pragma pack(1) 指令强制不进行对齐，但这可能会导致性能下降。在跨平台或跨编译器场景下特别注意这一点。
流的错误处理：
- 在文件操作时，一定要检查文件流的状态，确保文件成功打开、读取或写入。常见的错误处理函数包括 good()、bad()、fail() 和 eof()。
- 如上面示例中的 if (!inFile) 和 if (!outFile)，用于检查文件是否成功打开。
数据兼容性问题：
- 二进制文件保存的是原始内存数据，因此，如果在不同版本的程序中使用了不同的结构体定义，读取可能会失败。
- 为了避免这种问题，可以使用版本号、头信息或者使用 protobuf 等序列化库来进行版本兼容性处理。
二进制文件的大小与操作系统依赖：
- 一些数据类型（如 int、long）在不同的操作系统或编译器中大小可能不同。例如，在 32 位和 64 位系统上，long 的大小可能不一样。因此，最好使用固定宽度的数据类型，如 int32_t、int64_t。

6. 文件读写模式总结

std::ofstream：用于输出流（写入文件），可以指定 std::ios::binary 打开为二进制模式。
std::ifstream：用于输入流（读取文件），也可以指定 std::ios::binary 打开为二进制模式。
write()：写入二进制文件，要求传入 char* 指针以及写入的数据大小。
read()：读取二进制文件，要求传入 char* 指针以及要读取的数据大小。

7. 常见的二进制文件操作库

Boost Serialization：提供了一种简单的序列化机制，可以将 C++ 中的复杂对象（包括容器、类对象）序列化到二进制文件或文本文件中。
Protocol Buffers (protobuf)：谷歌开发的序列化工具，可以用于跨平台的数据结构定义及二进制文件读写，尤其适合网络传输和跨系统的场景。

8.文件流定位函数

1. 文件流定位相关的函数

C++ 提供了几个函数用于文件流的定位操作，主要是 seekg、seekp、tellg 和 tellp。它们用于在二进制文件中移动或查询文件读写位置。

seekg (seek get)：用于输入流（ifstream），调整读取位置。
seekp (seek put)：用于输出流（ofstream），调整写入位置。
tellg：用于查询输入流的当前位置。
tellp：用于查询输出流的当前位置。

2. 定位函数的用法

seekg(off, dir)：调整输入流的读取位置。off 是偏移量，dir 指定参考位置，可以是：
- std::ios::beg：相对于文件开头的偏移。
- std::ios::cur：相对于当前读取位置的偏移。
- std::ios::end：相对于文件末尾的偏移。
seekp(off, dir)：调整输出流的写入位置，用法与 seekg 类似。

示例：读取文件中的特定位置数据

假设我们有一个二进制文件，里面保存了多个结构体，我们想随机访问某个结构体。

#include <iostream>
#include <fstream>

struct Data {
int id;
double value;
};

int main() {
std::ifstream inFile("data.bin", std::ios::binary);

if (!inFile) {
std::cerr << "文件打开失败！" << std::endl;
return 1;
}

// 移动文件流位置到第 N 个结构体
int n = 2; // 假设我们想读取第 3 个结构体 (n=2)
inFile.seekg(n * sizeof(Data), std::ios::beg); // 移动到第 n+1 个结构体的位置

Data data;
inFile.read(reinterpret_cast<char *>(&data), sizeof(Data)); // 读取该结构体

inFile.close();

std::cout << "ID: " << data.id << " Value: " << data.value << std::endl;

return 0;
}

3. 定位相关的应用场景

场景 1：大文件的随机访问

当处理非常大的文件时，比如日志文件、数据库文件，通常不需要将文件全部读入内存。可以通过文件流的定位函数快速移动到文件的某个部分进行读取或写入，这样节省了内存和时间。

场景 2：记录日志中的某个数据块

假设日志文件中保存了多条记录，每条记录是定长的，通过 seekg 和 seekp，可以快速定位到特定的记录进行操作。

4. 文件定位的注意事项和常见问题

1. 相对定位和绝对定位的选择

使用 std::ios::beg 可以实现从文件开头的绝对定位。
使用 std::ios::cur 实现相对于当前文件指针的相对定位。
如果需要从文件末尾倒数定位，可以使用 std::ios::end，但要注意负值偏移。

2. 检查流的状态

每次移动文件指针后，应检查文件流的状态，确保定位操作成功。可以使用 inFile.good()、inFile.eof() 等方法来检查流状态。
特别注意：如果移动指针超过文件范围，可能会导致读取失败。此时要处理错误并确保文件流位置被正确设置。

3. 结构对齐问题的影响

在写入或读取自定义结构体时，要确保文件中数据的存储顺序和结构体的内存布局一致。例如，编译器对齐可能导致结构体内的成员间产生额外的空隙，影响数据的正确读取和定位。

4. tellg 和 tellp 的返回值

tellg 和 tellp 返回的值是当前文件流中的字节位置。这对调试非常有帮助，可以用来确保数据指针是否在正确的位置。

std::ifstream inFile("data.bin", std::ios::binary);
std::streampos pos = inFile.tellg(); // 获取当前读取位置
std::cout << "当前位置: " << pos << std::endl;

5. 跨平台字节序和大小端问题

如果在不同的系统（如大端和小端系统）之间共享二进制文件，文件中数据的顺序可能会不一致。这会影响读取的准确性。在这种情况下，可以手动调整字节序。

9. 文件定位操作的典型示例

示例：在二进制文件中写入多段数据并进行定位读取

#include <iostream>
#include <fstream>

struct Data {
int id;
double value;
};

int main() {
// 写入数据
std::ofstream outFile("data.bin", std::ios::binary);

Data data1 = { 1, 100.5 };
Data data2 = { 2, 200.5 };
Data data3 = { 3, 300.5 };

outFile.write(reinterpret_cast<char *>(&data1), sizeof(Data));
outFile.write(reinterpret_cast<char *>(&data2), sizeof(Data));
outFile.write(reinterpret_cast<char *>(&data3), sizeof(Data));
outFile.close();

// 读取数据（定位到第二段数据）
std::ifstream inFile("data.bin", std::ios::binary);

if (!inFile) {
std::cerr << "文件打开失败！" << std::endl;
return 1;
}

Data data;
inFile.seekg(sizeof(Data), std::ios::beg); // 跳过第一个数据

inFile.read(reinterpret_cast<char *>(&data), sizeof(Data)); // 读取第二个数据

inFile.close();

std::cout << "读取到的第二个数据: ID = " << data.id << ", Value = " << data.value << std::endl;

return 0;
}

总结

定位操作在处理大文件或随机访问文件中的特定数据时非常重要。常用的 seekg、seekp、tellg 和 tellp 可以帮助高效地实现文件中的随机访问。
定位操作时要注意流状态检查、字节序问题以及结构对齐可能带来的影响。
在开发中，文件的随机访问特别适用于日志文件分析、数据库文件存储或图像视频的局部修改。