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)模式。
  • 始终检查文件是否成功打开,并处理异常情况。
相关推荐
tan180°16 分钟前
MySQL表的操作(3)
linux·数据库·c++·vscode·后端·mysql
m0_5557629020 分钟前
Matlab 频谱分析 (Spectral Analysis)
开发语言·matlab
大千AI助手43 分钟前
DTW模版匹配:弹性对齐的时间序列相似度度量算法
人工智能·算法·机器学习·数据挖掘·模版匹配·dtw模版匹配
浪裡遊1 小时前
React Hooks全面解析:从基础到高级的实用指南
开发语言·前端·javascript·react.js·node.js·ecmascript·php
彭祥.2 小时前
Jetson边缘计算主板:Ubuntu 环境配置 CUDA 与 cudNN 推理环境 + OpenCV 与 C++ 进行目标分类
c++·opencv·分类
lzb_kkk2 小时前
【C++】C++四种类型转换操作符详解
开发语言·c++·windows·1024程序员节
YuTaoShao2 小时前
【LeetCode 热题 100】48. 旋转图像——转置+水平翻转
java·算法·leetcode·职场和发展
好开心啊没烦恼2 小时前
Python 数据分析:numpy,说人话,说说数组维度。听故事学知识点怎么这么容易?
开发语言·人工智能·python·数据挖掘·数据分析·numpy
生态遥感监测笔记2 小时前
GEE利用已有土地利用数据选取样本点并进行分类
人工智能·算法·机器学习·分类·数据挖掘