文件目录操作

文件系统 QT

文件目录操作相关类

Qt 为文件和目录操作提供了一些类，利用这些类可以方便地实现一些操作。Qt 提供的与文件和目录操作相关的类包括以下几个：

QCoreApplication：用于提取应用程序路径，程序名等文件信息；
QFile：除了打开文件操作外，QFile 还有复制文件、删除文件等功能；
QFileInfo：用于提取文件信息，包括路径、文件名、后缀等；
QTemporaryDir 和 QTemporaryFile：用于创建临时目录和临时文件；
QFileSystemWatcher：文件和目录监听类，监听目录下文件的添加、删除等变化，监听文件修改变化。

这些类基本涵盖了文件操作需要的主要功能，有些功能还在某些类中重复出现，例如 QFile 和 QDIr 都具有删除文件、判断文件是否存在的功能。

实例概述

QCoreApplication 类

QCoreApplication 是为无 GUI 应用程序提供事件循环的类，是所有应用程序类的基类，其子类 QGuiApplication 为有 GUI 界面的应用程序提供流控制和主要设定，QGuiApplication 的子类 QApplication 为基于 QWidget 的应用程序提供支持，包括界面的初始化等。

QCoreApplication 提供了一些有用的静态函数，可以获取应用程序名称、启动路径等信息，几个函数的名称和功能如下：

QFile 类

前面两篇文章使用 QFile 类进行文件操作，使用了 QFile::open()函数。除了打开文件提供读写操作外，QFile 还有一些静态函数和成员函数用于文件操作。

静态函数时无需创建 QFile 类对象实例就可以调用的函数，例如使用静态函数 exists()判断一个文件是否存在的代码如下：

void Dialog::on_pushButton_51_clicked()
{
    showBtnInfo(sender());
    QString sous=ui->editFile->text(); //源文件
    bool the=QFile::exists(sous);
    if(the)
        ui->plainTextEdit->appendPlainText(+"true \n");
    else
        ui->plainTextEdit->appendPlainText(+"false \n");
}

QFile 还提供了对应的函数成员如下（省略函数参数中的 const 关键字）：

创建 QFile 对象时可以在构造函数里指定文件名，也可以用 setFileName()指定文件，但是文件打开后不能再调用 setFileName()函数。指定的文件作为 QFile 对象的当前文件，然后成员函数 copy()、rename()等都是基于当前文件的操作。

QFileInfo 类

QFileInfo 类的接口函数提供文件的各种信息。QFileInfo 对象创建时可以指定一个文件名作为当前文件，也可以用 setFile() 函数指定一个文件作为当前文件。

QFileInfo 常见接口函数如下所示。除了一个静态函数 exists()之外，其他都是公共接口函数，接口函数的操作都是针对当前文件：

QFileInfo 提供的这些函数可以提取文件信息，包括目录名、文件基名、文件后缀等，利用这些函数可以实现灵活的文件操作。例如，下面的代码是利用 QFile::rename()函数和 QFileInfo 的一些功能实现的文件重命名功能的代码，其中就用到了提取路径、提取文件基名的功能。

void Dialog::on_pushButton_50_clicked()
{//QFile::rename()
    showBtnInfo(sender());
    QString sous=ui->editFile->text(); //源文件
    QFileInfo   fileInfo(sous);//源文件信息
    QString newFile=fileInfo.path()+"/"+fileInfo.baseName()+".XYZ"; //更改文件后缀为".XYZ"
    QFile::rename(sous,newFile); //重命名文件
    ui->plainTextEdit->appendPlainText("源文件："+sous);
    ui->plainTextEdit->appendPlainText("重命名为："+newFile+"\n");
}

QDir 类

QDir 是进行目录操作的类，在创建 QDir 对象时传递一个目录字符串作为当前目录，然后 QDir 函数就可以针对当前目录或目录下的文件进行操作。

在使用 QFileDialog 选择打开一个文件或目录时需要传递一个初始目录，这个时候就可以使用 QDir::currentPath()获取应用程序当前目录作为初始目录，前面一些实例程序的代码中已经用到过这个功能。

QDir 的一些公共函数接口如下：

获取目录下的目录或文件列表的函数 entryList()需要传递 QDir::Filter枚举类型的参数以获取不同的结果，QDir::Filter枚举类型的常用取值如下：

QDIr::AllDirs：列出所有目录名；
QDir::Files：列出所有文件；
QDir::Drives：列出所有盘符（Unix 系统下无效）；
QDir::NoDotAndDotDot：不列出特殊符号，如“.”和“..”；
QDir::AllEntries：列出目录下所有项目。

列出所有子目录的程序如下：

void Dialog::on_pushButton_11_clicked()
{//列出子目录
    showBtnInfo(sender());

    QDir    dir(ui->editDir->text());
    QStringList strList=dir.entryList(QDir::Dirs | QDir::NoDotAndDotDot);

    ui->plainTextEdit->appendPlainText("所选目录下的所有目录:");
    for(int i=0;i<strList.count();i++)
        ui->plainTextEdit->appendPlainText(strList.at(i));
    ui->plainTextEdit->appendPlainText("\n");

}

列出一个目录下所有文件的程序如下：

void Dialog::on_pushButton_17_clicked()
{//列出所有文件
    showBtnInfo(sender());
    QDir    dir(ui->editDir->text());
    QStringList strList=dir.entryList(QDir::Files);

    ui->plainTextEdit->appendPlainText("所选目录下的所有文件：");
    for(int i=0;i<strList.count();i++)
        ui->plainTextEdit->appendPlainText(strList.at(i));
    ui->plainTextEdit->appendPlainText("\n");
}

QTemporaryDir 和 QTemporaryFile

QTemporaryDir 是用于创建、删除临时目录的类，其主要函数如下：

在系统临时目录，及 QDir::tempPath目录下创建一个临时目录，临时目录名称以 QCoreApplication::applicationName()为前缀，后加 6 个字符。零时目录可以设置为使用完后自动删除，即临时目录变量删除。

QTemporaryFile 是用于创建临时文件的类，临时文件保存在系统临时目录下。临时文件以 QCoreApplication::applicationName()函数设置为是否自动删除临时文件。QTemporaryFile::open()函数用于打开临时文件，只有打开临时文件，才实际创建了此文件。

QFileSystemWatcher 类

QFileSystemWatcher 是对目录文件进行监听的类。把某些目录或文件添加到 QFileSystemWatcher 对象的监听列表后，当目录下发生文件新建、删除等操作时就会发射 directoryChanged()信号，当监听的文件发生修改、重命名等操作时，会发射 fileChanged()信号。所以，这个类在进行目录或文件监听时起作用。

QFileSystemWatcher 的主要接口函数如下：

为了测试 QFileSystemWatcher 的功能，在主窗口类中定义了 QFileSystemWatcher 类型的变量和两个信号的槽函数，定义如下：

private:
    QFileSystemWatcher  fileWatcher;
    void    showBtnInfo(QObject* btn);
public slots:
    void on_directoryChanged(const QString path);
    void on_fileChanged(const QString path);

两个槽函数仅是显示传递的参数，并显示提示文字，代码如下：

void Dialog::on_directoryChanged(const QString path)
{ //directoryChanged()信号的槽函数
    ui->plainTextEdit->appendPlainText(path);
    ui->plainTextEdit->appendPlainText("目录发生了变化\n");
}

void Dialog::on_fileChanged(const QString path)
{//fileChanged()信号的槽函数
    ui->plainTextEdit->appendPlainText(path);
    ui->plainTextEdit->appendPlainText("文件发生了变化\n");
}

QFileSystemWatcher 分组里“addPath()开始监听”和“removePath()停止监听”两个按钮的代码如下：

void Dialog::on_pushButton_46_clicked()
{//开始监听,addPath()
    showBtnInfo(sender());
    ui->plainTextEdit->appendPlainText("监听目录："+ui->editDir->text()+"\n");
    fileWatcher.addPath(ui->editDir->text());//添加监听目录
    fileWatcher.addPath(ui->editFile->text());//添加监听文件

    QObject::connect(&fileWatcher,&QFileSystemWatcher::directoryChanged,
            this,&Dialog::on_directoryChanged); //directoryChanged
    QObject::connect(&fileWatcher,&QFileSystemWatcher::fileChanged,
            this,&Dialog::on_fileChanged); //fileChanged
}

void Dialog::on_pushButton_47_clicked()
{//停止监听,removePath()
    showBtnInfo(sender());
    ui->plainTextEdit->appendPlainText("停止监听目录："+ui->editDir->text()+"\n");
    fileWatcher.removePath(ui->editDir->text());//
    fileWatcher.removePath(ui->editFile->text());//
    QObject::disconnect(&fileWatcher,&QFileSystemWatcher::directoryChanged,
            this,&Dialog::on_directoryChanged); //directoryChanged
    QObject::disconnect(&fileWatcher,&QFileSystemWatcher::fileChanged,
            this,&Dialog::on_fileChanged); //fileChanged
}

采用 addPath()函数添加目录和文件后，将信号和槽函数关联起来，开始监听。

停止监听时，用 removePath()函数移除监听的目录和文件，并用 disconnect()解除信号和槽的关联。

如果觉得文章对你有用，请随意赞赏

文件目录操作

https://huangyanjie.com/archives/16a82ad5-eb0c-47b3-b8cc-96ef49c6f149

作者

Lenn

发布于

2025-03-19

更新于

2025-03-19

许可协议

CC BY 4.0

文件目录操作