【Qt】QDataStream字节序介绍

QDataStream 是 Qt 中用于序列化和反序列化二进制数据的类，其字节序（Endianness）设置直接影响数据的读写方式。

1. 字节序基础

• 大端序（Big-Endian）：高位字节在前（如 0x12345678 存储为 12 34 56 78）。
• 小端序（Little-Endian）：低位字节在前（如 0x12345678 存储为 78 56 34 12）。

2. QDataStream 默认行为

• 默认字节序：历史版本中默认为大端序（BigEndian），但某些平台或新版本可能根据系统调整。建议显式设置以避免歧义。
• 设置方法：

  QDataStream stream;
  stream.setByteOrder(QDataStream::BigEndian);    // 设置为大端序
  // 或
  stream.setByteOrder(QDataStream::LittleEndian); // 设置为小端序
  

3. 跨平台与网络通信

• 网络传输：通常统一使用大端序（网络字节序），确保不同设备兼容。
• 本地存储：若仅限单一平台，可使用本地字节序提升效率；跨平台则需统一设置。

4. 数据类型影响

• 基本类型：int、float、double 等受字节序直接影响。
• Qt 类型：如 QString、QByteArray 等由 Qt 自动处理字节序，但底层数据仍依赖设置。

5. 版本兼容性

• 使用 QDataStream::setVersion() 设置数据流版本，确保读写双方使用同一序列化格式（不同 Qt 版本可能变化）。

6. 示例代码

// 写入数据（大端序）
QFile file("data.bin");
file.open(QIODevice::WriteOnly);
QDataStream out(&file);
out.setByteOrder(QDataStream::BigEndian);
out << quint32(0x12345678); // 显式写入32位无符号整数

// 读取数据（需一致设置）
QFile file("data.bin");
file.open(QIODevice::ReadOnly);
QDataStream in(&file);
in.setByteOrder(QDataStream::BigEndian);
quint32 value;
in >> value; // 正确读取 0x12345678

7. 注意事项

• 读写顺序一致：数据写入和读取顺序必须严格匹配。
• 测试验证：跨平台场景下需测试不同字节序设置，确保数据无误。
• 显式设置：始终明确字节序，避免依赖默认值导致意外行为。

总结

QDataStream 的字节序设置是确保数据正确解析的关键，尤其在网络通信或跨平台应用中。通过显式配置字节序和版本号，并保持读写一致性，可有效避免数据错误。