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)模式。
  • 始终检查文件是否成功打开,并处理异常情况。
相关推荐
鱼嘻5 分钟前
数据结构------C语言经典题目(6)
linux·c语言·开发语言·数据结构·算法
ProgramHan9 分钟前
JavaScript性能优化都优化什么
开发语言·javascript·ecmascript
彷徨而立12 分钟前
【C/C++】字符串拷贝方法
c++
快乐吃手手 : )39 分钟前
Java泛型(补档)
java·开发语言
泪光29291 小时前
枚举法——C++算法【泪光2929】
c++
Theodore_10221 小时前
Python3(19)数据结构
大数据·开发语言·数据结构·python·网络爬虫
fantasy_arch1 小时前
SVT-AV1源码分析-函数svt_aom_motion_estimation_kernel
人工智能·算法·av1
fantasy_arch1 小时前
SVTAV1 编码函数 svt_aom_is_pic_skipped
算法·av1
王大傻09281 小时前
python + segno 生成个人二维码
开发语言·python
RQ_ghylls2 小时前
3. 使用idea将一个git分支的部分提交记录合并到另一个git分支
开发语言·git·idea