Qt文本文件读写方法详解

在Qt中,读写文本文件主要通过 QFileQTextStream 类实现。以下是各种方法的详细说明及示例代码:


1. 使用 QFile 和 QTextStream 读写文本

1.1 读取整个文件
cpp 复制代码
QFile file("example.txt");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    qDebug() << "无法打开文件:" << file.errorString();
    return;
}
QTextStream in(&file);
QString content = in.readAll(); // 读取所有内容
file.close();
1.2 逐行读取文件
cpp 复制代码
QFile file("example.txt");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    QTextStream in(&file);
    while (!in.atEnd()) {
        QString line = in.readLine(); // 逐行读取
        qDebug() << line;
    }
    file.close();
}
1.3 写入文件(覆盖模式)
cpp 复制代码
QFile file("output.txt");
if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    QTextStream out(&file);
    out << "第一行内容\n";
    out << "第二行内容";
    file.close();
}
1.4 追加写入文件
cpp 复制代码
QFile file("output.txt");
if (file.open(QIODevice::Append | QIODevice::Text)) {
    QTextStream out(&file);
    out << "\n追加的内容";
    file.close();
}
1.5 设置编码格式
cpp 复制代码
QTextStream stream(&file);
stream.setEncoding(QStringConverter::Utf8); // Qt6+ 设置UTF-8
// 或 stream.setCodec("UTF-8"); // Qt5

2. 使用 QFile 直接读写(基于 QByteArray)

2.1 读取为 QByteArray
cpp 复制代码
QFile file("example.txt");
if (file.open(QIODevice::ReadOnly)) {
    QByteArray data = file.readAll();
    QString content = QString::fromUtf8(data); // 转为QString
    file.close();
}
2.2 写入 QByteArray
cpp 复制代码
QFile file("output.txt");
if (file.open(QIODevice::WriteOnly)) {
    QByteArray data = "Hello, Qt!".toUtf8();
    file.write(data);
    file.close();
}

3. 其他注意事项

3.1 文件打开模式
  • QIODevice::ReadOnly:只读
  • QIODevice::WriteOnly:覆盖写入
  • QIODevice::Append:追加写入
  • QIODevice::Text:自动处理换行符(\n 转换为平台相关换行符)
3.2 错误处理

检查文件是否成功打开:

cpp 复制代码
if (!file.open(...)) {
    qDebug() << "错误:" << file.errorString();
}
3.3 大文件处理

逐块读取以避免内存占用过高:

cpp 复制代码
QFile file("largefile.txt");
if (file.open(QIODevice::ReadOnly)) {
    while (!file.atEnd()) {
        QByteArray chunk = file.read(1024); // 每次读取1KB
        // 处理chunk...
    }
    file.close();
}

4. 完整示例:读写文件操作

cpp 复制代码
#include <QFile>
#include <QTextStream>
#include <QDebug>

void readWriteDemo() {
    // 写入文件
    QFile writeFile("test.txt");
    if (writeFile.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&writeFile);
        out << "姓名:张三\n年龄:25";
        writeFile.close();
    }

    // 读取文件
    QFile readFile("test.txt");
    if (readFile.open(QIODevice::ReadOnly | QIODevice::Text)) {
        QTextStream in(&readFile);
        qDebug() << "文件内容:\n" << in.readAll();
        readFile.close();
    }
}

5. 高级用法

  • QSaveFile :安全写入文件(原子操作,避免写入中途崩溃导致数据丢失):

    cpp 复制代码
    QSaveFile saveFile("important.txt");
    if (saveFile.open(QIODevice::WriteOnly)) {
        QTextStream out(&saveFile);
        out << "安全保存的内容";
        saveFile.commit(); // 只有commit才会替换原文件
    }

总结

  • QTextStream:推荐用于文本处理(自动处理编码和换行符)。
  • QFile + QByteArray:适合直接操作字节数据或二进制文件。
  • 根据需求选择覆盖(WriteOnly)或追加(Append)模式。
  • 始终检查文件是否成功打开,并处理异常情况。
相关推荐
forwiat13 分钟前
日拱一卒【6】
算法
Dovis(誓平步青云)36 分钟前
探索C++对象模型:This指针与(构造、析构)成员函数的深度解析(中篇)
开发语言·c++·经验分享·笔记·学习方法
Echo``1 小时前
6:OpenCV—图像滤波
c++·人工智能·opencv·算法·计算机视觉
DXM05211 小时前
FME入门系列教程7-基于FME的ArcGIS空间数据互操作技术研究与实践
xml·开发语言·笔记·arcgis·fme·arcgis engine
全马必破三1 小时前
前端性能优化方案
开发语言·前端·javascript
苏克贝塔1 小时前
使用 Qt QGraphicsView/QGraphicsScene 绘制色轮
开发语言·qt
phoenix@Capricornus1 小时前
极大似然估计
算法·机器学习·概率论
一个天蝎座 白勺 程序猿1 小时前
Python爬虫(34)Python爬虫高阶:动态页面处理与Playwright增强控制深度解析
开发语言·爬虫·python
看到代码就头晕2 小时前
python学习 day5
开发语言·python·学习
乌托邦的逃亡者2 小时前
使用JProfiler进行Java应用性能分析
java·开发语言·性能优化