Qt 5 中的 QTextStream 使用指南

介绍

QTextStream 是 Qt 框架中用于处理文本数据的类。它提供了方便的接口来读写文本文件或字符串，支持多种编码格式，并且可以与 QIODevice 类（如 QFile、QTcpSocket 等）结合使用。本文将介绍如何在 Qt 5.15.2 中使用 QTextStream 进行基本的文件读写操作。

基本概念

‌QTextStream‌：提供文本输入输出的流类。
‌QIODevice‌：提供读写设备的基础类，QTextStream 通常与它的子类（如 QFile）一起使用。
‌编码‌：QTextStream 支持多种文本编码，如 UTF-8、UTF-16 等。
创建 QTextStream 对象

要创建一个 QTextStream 对象，你通常需要先创建一个 QIODevice 对象（如 QFile），然后将这个设备对象传递给 QTextStream 的构造函数。

#include <QFile>
#include <QTextStream>
#include <QDebug>int main() {// 创建一个 QFile 对象QFile file("example.txt");// 以写入模式打开文件if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {qDebug() << "无法打开文件用于写入";return -1;}// 创建一个 QTextStream 对象用于写入QTextStream out(&file);out << "Hello, Qt!\n";out << "This is a test.\n";// 关闭文件file.close();return 0;
}

// 从 QFile 对象创建文本流
QFile file("example.txt");
if (file.open(QIODevice::ReadWrite | QIODevice::Text)) {QTextStream in(&file);// ... 用于读取QTextStream out(&file);// ... 用于写入
}// 从 QString 创建文本流
QString str;
QTextStream stream(&str);
stream << "Hello, World!"; // 将字符串写入到 str 中// 从 QByteArray 创建文本流
QByteArray data;
QTextStream byteStream(&data);
byteStream << "Some text data";

QFile outputFile("output.txt");
if (outputFile.open(QIODevice::WriteOnly | QIODevice::Text)) {QTextStream out(&outputFile);out << "Writing some text to the file...\n";out << "Line 2...\n";out << QStringLiteral("Line 3 with formatted value: %1").arg(42); // 格式化输出
}

读取文件

要读取一个文本文件，你可以以读取模式打开文件，并创建一个 QTextStream 对象用于读取。

#include <QFile>
#include <QTextStream>
#include <QDebug>int main() {// 创建一个 QFile 对象QFile file("example.txt");// 以读取模式打开文件if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {qDebug() << "无法打开文件用于读取";return -1;}// 创建一个 QTextStream 对象用于读取QTextStream in(&file);while (!in.atEnd()) {QString line = in.readLine();qDebug() << line;}// 关闭文件file.close();return 0;
}

QFile inputFile("input.txt");
if (inputFile.open(QIODevice::ReadOnly | QIODevice::Text)) {QTextStream in(&inputFile);while (!in.atEnd()) {QString line = in.readLine(); // 逐行读取qDebug() << line;}
}

注意事项

‌文件打开模式‌：确保你以正确的模式打开文件（写入、读取、追加等）。
‌编码‌：如果你需要处理特定编码的文本，可以在创建 QTextStream 对象时指定编码。
‌异常处理‌：在实际应用中，你应该添加更多的错误处理代码来确保程序的健壮性。

结论

QTextStream 是 Qt 中一个非常有用的类，它简化了文本数据的读写操作。通过与 QIODevice 类的结合使用，你可以轻松地处理各种文本文件。本文介绍了 QTextStream 的基本概念和用法，并提供了一些简单的示例代码。希望这些内容能帮助你更好地理解和使用 QTextStream。