一、QDataStream的构造函数

在 Qt 中，QDataStream 类提供了对二进制数据的序列化和反序列化功能，方便地在文件或网络中读写各种数据类型。

• QDataStream()：默认构造函数。
• QDataStream(QIODevice *device)：使用指定的 QIODevice 对象初始化数据流。
• QDataStream(QByteArray *byteArray, QIODevice::OpenMode mode)：使用指定的字节数组和打开模式初始化数据流。

1.创建一个空的 QDataStream 对象
使用默认构造函数创建的 QDataStream 对象在初始化时未绑定任何设备或数据缓冲区。要使其可用于读写操作，需要在稍后阶段通过 setDevice() 方法将其与一个 QIODevice 对象（如 QFile、QBuffer 等）关联。

示例代码：

#include <QFile>
#include <QDataStream>
#include <QDebug>int main() {// 创建一个 QDataStream 对象，未绑定任何设备QDataStream stream;// 创建一个 QFile 对象并打开QFile file("data.dat");if (!file.open(QIODevice::WriteOnly)) {qWarning() << "无法打开文件进行写入";return 1;}// 将 QDataStream 与 QFile 关联stream.setDevice(&file);// 设置数据流版本（可选，但建议设置以确保兼容性）stream.setVersion(QDataStream::Qt_6_5);// 写入数据qint32 number = 42;QString text = "Hello, QDataStream!";stream << number << text;// 关闭文件file.close();// 读取数据if (!file.open(QIODevice::ReadOnly)) {qWarning() << "无法打开文件进行读取";return 1;}// 将 QDataStream 与 QFile 重新关联stream.setDevice(&file);qint32 readNumber;QString readText;stream >> readNumber >> readText;// 输出读取的数据qDebug() << "读取的数字:" << readNumber;qDebug() << "读取的文本:" << readText;// 关闭文件file.close();return 0;
}

2.绑定到一个 QIODevice（如 QFile、QTcpSocket 等）
通过此构造函数，您可以将 QDataStream 与任何继承自 QIODevice 的设备（如 QFile、QBuffer、QTcpSocket 等）关联，以实现对这些设备的二进制数据读写操作。
以下示例演示了如何使用 QDataStream 将整数和字符串写入文件，然后再读取这些数据：

#include <QFile>
#include <QDataStream>
#include <QDebug>int main() {// 创建一个 QFile 对象并指定文件名QFile file("data.dat");// 以写入模式打开文件if (!file.open(QIODevice::WriteOnly)) {qWarning() << "无法打开文件进行写入";return 1;}// 将 QDataStream 与 QFile 关联QDataStream out(&file);// 设置数据流版本（可选，但建议设置以确保兼容性）out.setVersion(QDataStream::Qt_6_5);// 写入数据到文件qint32 number = 42;QString text = "Hello, QDataStream!";out << number << text;// 关闭文件file.close();// 以读取模式重新打开文件if (!file.open(QIODevice::ReadOnly)) {qWarning() << "无法打开文件进行读取";return 1;}// 将 QDataStream 与 QFile 重新关联QDataStream in(&file);in.setVersion(QDataStream::Qt_6_5);// 读取数据qint32 readNumber;QString readText;in >> readNumber >> readText;// 输出读取的数据qDebug() << "读取的数字:" << readNumber;qDebug() << "读取的文本:" << readText;// 关闭文件file.close();return 0;
}

3.绑定到一个 QByteArray，用于内存中的序列化
在 Qt 中，QDataStream 提供了一个构造函数，允许直接对 QByteArray 进行读写操作。

QDataStream(QByteArray *byteArray, QIODevice::OpenMode mode);

参数说明：

• byteArray：指向目标 QByteArray 对象的指针。
• mode：指定数据流的打开模式，通常为 QIODevice::ReadOnly、QIODevice::WriteOnly 或 QIODevice::ReadWrite。

注意：由于 QByteArray 不是 QIODevice 的子类，QDataStream 内部会创建一个 QBuffer 来包装该字节数组，以实现对其的读写操作。

示例代码：

#include <QByteArray>
#include <QDataStream>
#include <QDebug>int main() {// 创建一个空的 QByteArrayQByteArray byteArray;// 将 QDataStream 绑定到 QByteArray，设置为读写模式QDataStream out(&byteArray, QIODevice::WriteOnly);// 设置数据流版本（可选，但建议设置以确保兼容性）out.setVersion(QDataStream::Qt_6_5);// 写入数据到 QByteArrayqint32 number = 42;QString text = "Hello, QDataStream!";out << number << text;// 输出写入后的 QByteArray 大小qDebug() << "Byte array size after writing:" << byteArray.size();// 读取数据QDataStream in(&byteArray, QIODevice::ReadOnly);in.setVersion(QDataStream::Qt_6_5);qint32 readNumber;QString readText;in >> readNumber >> readText;// 输出读取的数据qDebug() << "Read number:" << readNumber;qDebug() << "Read text:" << readText;return 0;
}

二、QDataStream的读写操作符

QDataStream 提供了重载的插入（<<）和提取（>>）操作符，用于写入和读取各种数据类型。

写入数据：

#include <QFile>
#include <QDataStream>QFile file("data.dat");
if (file.open(QIODevice::WriteOnly)) {QDataStream out(&file);qint32 number = 42;QString text = "Hello, QDataStream!";out << number << text;file.close();
}

读取数据：

#include <QFile>
#include <QDataStream>QFile file("data.dat");
if (file.open(QIODevice::ReadOnly)) {QDataStream in(&file);qint32 number;QString text;in >> number >> text;file.close();// 使用读取的数据
}

三、QDataStream的状态检查

• QDataStream::Status status() const
  返回流的状态，可能的值包括：
  • QDataStream::Ok：正常。
  • QDataStream::ReadPastEnd：读取超出数据范围。
  • QDataStream::ReadCorruptData：数据损坏。

if (stream.status() != QDataStream::Ok) {qWarning() << "Stream error!";
}

• void resetStatus()
  重置流的状态为 Ok。

stream.resetStatus();

四、QDataStream的版本控制

• void setVersion(int)
  设置流的版本号，用于兼容不同版本的序列化格式。

stream.setVersion(QDataStream::Qt_6_0);

• int version() const
  获取当前流的版本号。

int version = stream.version();

五、QDataStream的序列化自定义类型

#include <QDataStream>
#include <QString>class Person {
public:QString name;int age;friend QDataStream& operator<<(QDataStream& stream, const Person& person) {stream << person.name << person.age;return stream;}friend QDataStream& operator>>(QDataStream& stream, Person& person) {stream >> person.name >> person.age;return stream;}
};int main() {Person person;person.name = "Alice";person.age = 30;QByteArray byteArray;QDataStream stream(&byteArray, QIODevice::WriteOnly);stream << person;QDataStream readStream(&byteArray, QIODevice::ReadOnly);Person readPerson;readStream >> readPerson;qDebug() << "Name:" << readPerson.name << "Age:" << readPerson.age;return 0;
}