目录
QTextStream类在Qt 5.15中的详细介绍
一、引言
QTextStream是Qt框架中的一个类，它提供了基于文本的输入输出流接口。与QDataStream不同，QTextStream主要处理的是文本数据，包括字符、字符串、数字以及常见的文本格式（如行结束符、空格等）。QTextStream可以与多种Qt的I/O设备（如文件、内存缓冲区、网络连接等）关联，使得文本数据的读写变得简单而高效。
二、使用范围
QTextStream广泛应用于以下场景：
- 文件读写：将文本数据保存到文件中，或从文件中读取文本数据。
- 网络通信：通过网络发送和接收文本数据，实现基于文本的协议通信。
- 控制台输入输出：在控制台应用程序中，与用户进行文本交互。
- 内存中的文本处理：在内存中处理文本数据，如字符串的拼接、格式化等。
三、类的头文件
QTextStream类的头文件是<QTextStream>。在使用QTextStream时，需要包含这个头文件。
cpp
#include <QTextStream>四、类的注意事项
- 编码 ：QTextStream默认使用系统的本地编码来处理文本数据。如果需要与其他编码格式的系统进行交互，可以使用
setCodec()或setCodecName()函数来设置编码。 - 自动换行 ：QTextStream会自动处理行结束符。在写入文本时，使用
\n作为换行符，QTextStream会根据目标设备的平台自动转换为相应的行结束符（如Windows上的\r\n，Unix/Linux上的\n）。 - 设备状态：在读写文本之前，应确保关联的I/O设备处于正确的状态（如已打开）。如果设备状态不正确，QTextStream的操作可能会失败。
- 错误处理 ：QTextStream提供了错误处理机制，可以通过
atEnd()和status()函数来检查流的状态，以便在发生错误时采取相应的措施。
五、类的继承
QTextStream是一个独立的类，不继承自其他Qt类。它提供了用于读写文本数据的接口，并与Qt的I/O设备系统紧密结合。
六、类的构造介绍
QTextStream有两个主要的构造函数，分别用于基于设备（如文件、缓冲区等）和基于字符串的流。
- QTextStream(QIODevice *device)：创建一个与指定设备关联的QTextStream对象。设备可以是文件、内存缓冲区、网络连接等。
- QTextStream(QString *string, QIODevice::OpenMode mode = QIODevice::ReadWrite)：创建一个与指定字符串关联的QTextStream对象。这种模式通常用于在内存中处理文本数据。
七、公有函数介绍
QTextStream提供了一系列公有函数来读写文本数据。以下是一些常用的公有函数：
- *QIODevice device() const：返回与流关联的设备对象（如果有的话）。
- void setDevice(QIODevice *device)：设置与流关联的新设备对象。
- bool atEnd() const：检查是否已到达流的末尾。
- QStream::Status status() const：返回流的当前状态。
- void setCodec(QTextCodec *codec)：设置用于编码和解码文本的QTextCodec对象。
- void setCodecName(const char *codecName)：根据名称设置用于编码和解码文本的QTextCodec对象。
- *QTextCodec codec() const：返回当前用于编码和解码文本的QTextCodec对象。
- QString codecName() const：返回当前用于编码和解码文本的QTextCodec对象的名称。
此外，QTextStream还重载了<<和>>运算符，用于写入和读取文本数据。
八、Static函数介绍
QTextStream没有提供静态函数。它的所有功能都通过对象实例的方法来实现。
九、运算符重载
QTextStream重载了<<（插入运算符）和>>（提取运算符），以便能够方便地将文本数据写入流和从流中读取文本数据。这些运算符对于基本数据类型（如int、float、QString等）以及常见的文本格式都是可用的。
例如，可以使用<<运算符将整数、浮点数、字符串等写入QTextStream：
cpp
QTextStream out(stdout);
out << "Hello, World!" << 123 << 45.67;同样地，可以使用>>运算符从QTextStream中读取文本数据：
cpp
QTextStream in(stdin);
QString str;
int num;
in >> str >> num;十、详细代码举例
以下是一个使用QTextStream的示例代码，用于演示如何将文本数据写入文件，并从文件中读取文本数据。
cpp
#include <QCoreApplication>
#include <QTextStream>
#include <QFile>
#include <QIODevice>
#include <QString>
#include <QDebug>
int main(int argc, char *argv[]) {
QCoreApplication app(argc, argv);
// 创建并打开一个文件用于写入
QFile fileOut("output.txt");
if (!fileOut.open(QIODevice::WriteOnly | QIODevice::Text)) {
qWarning() << "Failed to open file for writing";
return -1;
}
// 创建与文件关联的QTextStream对象用于写入
QTextStream out(&fileOut);
out << "This is a line of text.\n";
out << "Another line with a number: " << 42 << ".\n";
fileOut.close();
// 打开同一个文件用于读取
QFile fileIn("output.txt");
if (!fileIn.open(QIODevice::ReadOnly | QIODevice::Text)) {
qWarning() << "Failed to open file for reading";
return -1;
}
// 创建与文件关联的QTextStream对象用于读取
QTextStream in(&fileIn);
QString line;
while (!in.atEnd()) {
line = in.readLine();
qDebug() << line;
}
fileIn.close();
return app.exec();
}在这个示例中，我们首先创建了一个名为output.txt的文件，并使用QTextStream将两行文本写入该文件。然后，我们重新打开该文件以进行读取，并使用QTextStream逐行读取文本数据，最后将其打印到控制台。这个示例展示了QTextStream在文件读写方面的基本用法。
