【QT】文件目录操作

1 文件目录操作相关的类

2 实例概述

2.1 实例功能

2.2 信号发射者信息的获取

3 QCoreApplication类

4 QFile类

5 QFilelnfo类

6 QDir类

7 QTemporaryDir和QTemporaryFiIe

8 QFiIeSystemWatcher类

文件的读写是很多应用程序具有的功能，甚至某些应用程序就是围绕着某一种格式文件的处理而开发的，所以文件读写是应用程序开发的一个基本功能。

1 文件目录操作相关的类

Qt为文件和目录操作提供了一些类，利用这些类可以方便地实现一些操作。Qt提供的与文件

和目录操作相关的类包括以下几个。

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

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

2 实例概述

2.1 实例功能

实例samp7_3演示前述各种目录与文件操作类的主要功能，图7-3是实例运行时的窗口。窗口左侧是一个QToolBox组件，分为6组，每一组是一个或两个类的功能演示，在每个组里放置一些QPushButton按钮，每个按钮主要调用类的某个函数，按钮的标题就是使用的函数的名称。

窗口右侧是显示区，可以选择一个目录、一个文件，然后左侧的功能基本上都是对选择的目录或文件进行操作，右下方是一个QPlainTextEdit组件，用于显示信息。

2.2 信号发射者信息的获取

每个按钮一般用函数名称作为标题，例如“QFileInfo类”分组里的按钮"baseName()”是要演示QFileInfo的baseName()函数。另外，将Qt帮助文件里的这个函数的基本描述文字复制作为按钮的ToolTip文字，例如"baseName()"按钮的ToolTip属是“Returns the base name of the file without the path”。

图7-3 实例samp7_3运行时窗口

在按钮被单击时，先显示按钮的标题和ToolTip信息，以便明显地知道按钮演示的功能。例如，"baseName()”按钮的clicked()槽函数代码如下：

void Dialog::on_pushButton_30_clicked()
{//QFileInfo.basename()QPushButton *btn = (QPushButton*) sender();ui->plainTextEdit->appendPlainText(btn->text());ui->plainTextEdit->appendPlainText(btn->toolTip());QFileInfo  fileInfo(ui->editFile->text());QString  str=fileInfo.baseName();ui->plainTextEdit->appendPlainText(str+"\n");
}

代码的前3行是用于获取按钮对象，并显示按钮的text和toolTip文字。

这里用到了QObject::sender()函数，该函数用于在槽函数里获取发射信号的对象。因为这个函数是按钮的clicked()信号的槽函数，所以，sender()获取的信号发射对象就是这个按钮。然后将此对象转换为QPushButton类型变量btn，就可以访问btn的text()和toolTip()函数了。

这种方法的优点是没有出现对象的ObjectName，这3行代码可以在任何一个按钮的clicked()信号槽函数里出现。如果是直接用按钮的ObjectName，则每个按钮里的代码里需要修改名称。本实例有几十个按钮，工作量很大，也容易遗漏了修改名称。

对上面的代码还可以进一步优化，因为每个按钮的槽函数里都要重复这3行代码，将其编写为一个函数，然后在按钮的响应代码里调用。优化后的代码如下：

void Dialog::on_pushButton_30_clicked()
{//QFileInfo.basename()showBtnInfo(sender());QFileInfo  fileInfo(ui->editFile->text());QString  str=fileInfo.baseName();ui->plainTextEdit->appendPlainText(str+"\n");
}void Dialog::showBtnInfo(QObject *btn)
{ //显示btn的信息QPushButton *theBtn =static_cast<QPushButton*>(btn);ui->plainTextEdit->appendPlainText(theBtn->text());ui->plainTextEdit->appendPlainText(theBtn->toolTip()+"\n");
}

在主窗口类中定义一个私有函数showBtnInfo()，接收QObject *btn对象作为输入参数，将 QObject对象转换为QPushButton对象，然后显示按钮的text和toolTip。

在按钮的响应代码里只需用一行语句调用showBtnInfo()函数，并将sender()作为参数传递。

本实例有几十个按钮，每个按钮的响应代码的第一行都是showBtnInfo(sender())，这样可以大大简化代码。

3 QCoreApplication类

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

创建的Qt Widget Application都是基于QApplication的，在main()函数里可以看到QApplication 的应用。

QCoreApplication提供了一些有用的静态函数，可以获取应用程序的名称、启动路径等信息，几个函数的名称和功能见表7-4（省略了函数参数中的const关键字）。

4 QFile类

前面使用QFile类进行文件的操作，应用了QFile::open()函数。除了打开文件提供读写操作外，QFile还有一些静态函数和成员函数用于文件操作。表7-5是QFile的一些静态函数（省略了函数参数中的const关键字）。

静态函数是无需创建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");elseui->plainTextEdit->appendPlainText(+"false \n");
}

QFile还提供了对应的成员函数，见表7-6（省略了函数参数中的const关键字）。

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

5 QFilelnfo类

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

QFileInfo常见接口函数和功能见表7-7。除了一个静态函数exists()之外，其他都是公共接口函数，接口函数的操作都是针对当前文件（省略了函数参数中的const关键字）。

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");
}

表7-7中的函数的使用方法和执行效果不再详细列举和说明，运行实例samp7_3观察执行结果，可参考Qt帮助文件或samp7_3的源程序看函数使用方法。

6 QDir类

QDir是进行目录操作的类，在创建QDir对象时传递一个目录字符串作为当前目录，然后QDir 函数就可以针对当前目录或目录下的文件进行操作。表7一8是QDir的一些静态函数（省略了函数参数中的const关键字）。

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

表7-9是QDir的一些公共接口函数（省略了函数参数中的const关键字）。

获取目录下的目录或文件列表的函数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");
}

7 QTemporaryDir和QTemporaryFiIe

QTemporaryDir是用于创建、删除临时目录的类，其主要函数见表7-10。

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

QTemporaryFile是用于创建临时文件的类，临时文件保存在系统临时目录下。临时文件以 QCoreApplication::applicationName()作为文件名，以“xxxxxx”6个随机数字作为文件后缀。将 QTemporaryFile::

setAutoRemove()函数设置为是否自动删除临时文件QTemporaryFile::

open()函数用于打开临时文件，只有打开临时文件，才实际创建了此文件。

8 QFiIeSystemWatcher类

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

QFileSystemWatcher的主要接口函数见表7-11（省略了函数参数中的const关键字）。

QFileSystemWatcher有两个信号，分别是目录变化和文件变化时发射的信号。

void QFileSystemWatcher::directoryChanged(const QString &path)

void QFileSystemWatcher::fileChanged(const QString &path)

图7-4是实例中测试QFileSystemWatcher的界面。首先打开一个目录和一个文件，单击 "addPath()开始监听”按钮将文件和目录都添加到监听列表，并且将信号与槽函数关联起来。然后在目录下复制某个文件，会发射directoryChanged()信号，重命名所监听的文件后会发射fileChanged() 信号，如图7-4所示的运行结果。

图7-4测试QFileSystemWatcher的运行界面

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

private:QFileSystemWatcher  fileWatcher;
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");
}

图7-4中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); //directoryChangedQObject::connect(&fileWatcher,&QFileSystemWatcher::fileChanged,this,&Dialog::on_fileChanged); //fileChangedthis,&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); //directoryChangedQObject::disconnect(&fileWatcher,&QFileSystemWatcher::fileChanged,this,&Dialog::on_fileChanged); //fileChanged
}

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

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