在很多时候我们需要读写文本文件进行读写,比如写个 Mp3 音乐播放器需要读 Mp3 歌词里的文本,比如修改了一个 txt 文件后保存,就需要对这个文件进行读写操作。本文介绍简单的文本文件读写,内容精简,让大家了解文本读写的基本操作。
QFile 读写文本
QFile 类提供了读取和写入文件的接口。在嵌入式里如果需要读写文件,最简单的方法就是 用 Qfile,例如利用QFile来读写 Linux 下的字符设备(可把字符设备当作一个文本处理,linux 下一切皆文件),虽然只是写‘0’或‘1’,但也是对文件(文本)的读写了。
QFile 是一个读写文本、二进制文件和资源的 I/O 设备。QFile 可以自己使用,也可以更方便地与 QTextStream 或 QDataStream 一起使用。
文件名通常在构造函数中传递,但它可以在任何时候使用 setFileName()设置。不支持使用其他分隔符(例如'\')。所以在 Windows、Linux 或者 Mac 里文件的路径都是用'/'。不能看到 Windows 的路径是'\',我们就可以在写入的文件路径里添加这个'\'。不管操作系统是什么,QFile 的文件分隔符都是'/'。
可以使用 exists()检查文件是否存在,并使用 remove()删除文件。(更高级的文件系统相关操 作由 QFileInfo 和 QDir 提供)用 open()打开文件,用 close()关闭文件,用 flush()刷新文件。通常使用 QDataStream 或 QTextStream 读写数据,但也可以调用 QIODevice 继承的函数 read()、 readLine()、readAll()、write()。QFile 还继承 getChar()、putChar()和 ungetChar(),它们一次只处 理一个字符。文件的大小由 size()返回。可以使用 pos()获取当前文件位置,也可以使用 seek() 移动到新的文件位置。如果已经到达文件的末尾,则 atEnd()返回 true。
QFile::open()函数打开文件时需要传递 QIODevice::OpenModeFlag 枚举类型的参数,决定 文件以什么方式打开,QIODevice::OpenModeFlag 类型的主要取值如下:
- QIODevice::ReadOnly:以只读方式打开文件,用于载入文件。
- QIODevice::WriteOnly:以只写方式打开文件,用于保存文件。
- QIODevice::ReadWrite:以读写方式打开。
- QIODevice::Append:以添加模式打开,新写入文件的数据添加到文件尾部。
- QIODevice::Truncate:以截取方式打开文件,文件原有的内容全部被删除。
- QIODevice::Text:以文本方式打开文件,读取时“\n”被自动翻译为换行符,写入时字符 串结束符会自动翻译为系统平台的编码,如 Windows 平台下是“\r\n”。
这些取值可以组合,例如 QIODevice::ReadOnly | QIODevice::Text 表示以只读和文本方式打开文件。
使用 QFile 对一个文本文件的操作流程是以下这样的。
应用实例
创建项目qfile_test,在头文件“mainwindow.h”具体代码如下。
#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include <QTextEdit>
#include <QFile>
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QPushButton>class MainWindow : public QMainWindow
{Q_OBJECTpublic:MainWindow(QWidget *parent = nullptr);~MainWindow();
private:/* 用于读取文件后显示 */QTextEdit *textEdit;/* QFile 类型对象 */QFile file;/* 布局 */QHBoxLayout *hBoxLayout;QVBoxLayout *vBoxLayout;QWidget *hWidget;QWidget *vWidget;/* 打开文件按钮 */QPushButton *openPushButton;/* 关闭文件按钮 */QPushButton *clsoePushButton;
private slots:/* 打开文本文件 */bool openFile();/* 关闭文本文件 */void closeFile();
};
#endif // MAINWINDOW_H
在源文件“mainwindow.cpp”具体代码如下。
#include "mainwindow.h"
#include <QFileDialog>
#include <QDebug>MainWindow::MainWindow(QWidget *parent): QMainWindow(parent)
{/* 设置窗口的位置与大小 */this->setGeometry(0, 0, 800, 480);/* 布局设置 */textEdit = new QTextEdit();vBoxLayout = new QVBoxLayout();hBoxLayout = new QHBoxLayout();vWidget = new QWidget();hWidget = new QWidget();openPushButton = new QPushButton();closePushButton = new QPushButton();/* 设置两个按钮的大小 */openPushButton->setMinimumHeight(50);openPushButton->setMaximumWidth(120);closePushButton->setMinimumHeight(50);closePushButton->setMaximumWidth(120);/* 设置两个按钮的文本 */openPushButton->setText("打开");closePushButton->setText("关闭");/* 设置关闭按钮为不可用属性,需要打开文件才设置为可用属性 */closePushButton->setEnabled(false);/* 水平布局 */hBoxLayout->addWidget(openPushButton);hBoxLayout->addWidget(closePushButton);hWidget->setLayout(hBoxLayout);/* 垂直布局 */vBoxLayout->addWidget(textEdit);vBoxLayout->addWidget(hWidget);vWidget->setLayout(vBoxLayout);/* 居中 */setCentralWidget(vWidget);/* 信号槽连接 */connect(openPushButton, SIGNAL(clicked()), this, SLOT(openFile()));connect(closePushButton, SIGNAL(clicked()), this, SLOT(closeFile()));
}MainWindow::~MainWindow()
{
}bool MainWindow::openFile(){/* 获取文件的路径 */QString fileName = QFileDialog::getOpenFileName(this);/* 指向文件 */file.setFileName(fileName);/* 判断文件是否存在 */if(!file.exists())return false;/* 以读写的方式打开 */if(!file.open(QIODevice::ReadOnly | QIODevice::Text))return false;/* 读取文本到 textEdit */textEdit->setPlainText(file.readAll());/* 设置打开按钮不可用,需要关闭再打开 */openPushButton->setEnabled(false);/* 设置关闭按钮为可用属性 */closePushButton->setEnabled(true);/* 关闭文件 */file.close();return true;
}
void MainWindow::closeFile(){/* 检测打开按钮是否可用,不可用时,说明已经打开了文件 */if(!openPushButton->isEnabled()){/* 获取 textEdit 的文本内容 */QString str = textEdit->toPlainText();/* 以只读的方式打开 */if(!file.open(QIODevice::WriteOnly | QIODevice::Text))return;/* 转换为字节数组 */QByteArray strBytes = str.toUtf8();/* 写入文件 */file.write(strBytes, strBytes.length());/* 清空 textEdit 的显示内容 */textEdit->clear();/* 关闭文件 */file.close();/* 重新设置打开和关闭按钮的属性 */openPushButton->setEnabled(true);closePushButton->setEnabled(false);}
}
程序运行效果
点击打开
调用系统打开文件的窗口。选择一个文本文件。
打开后,文本的内容如下,可以进行修改,修改后点击关闭就会写入到此文件里。本例仅仅用两个按钮和一个文本编辑框完成,内容简洁易懂。但是在实际项目里不是用 QPushButton 来做打开文件和关闭文件的,一般设计于在菜单栏里用 QAction 来做。包括添加复制、粘贴、 另存为、关闭、等等。可以仿照 Windows 里的记事本,用 Qt 写一个类似的软件完全可以。