Qt QDir路径类及使用方法
作者：人才程序员
QDir 详解
前言
文件和目录操作是软件开发中常见的任务，例如遍历文件夹、检查文件是否存在、创建文件夹等。Qt 提供了一个功能强大的类——QDir，专门用于操作文件系统中的目录。QDir 封装了多种平台独立的文件系统操作方法，使得开发者可以轻松地在跨平台项目中处理文件和目录。
本文将介绍 QDir 的用途，列举常用的构造函数和成员函数，并结合代码示例，帮助开发者全面掌握 QDir 的使用方法。
什么是 QDir？
QDir 是 Qt 的一个类，专门用于操作文件系统中的目录。它提供了一系列方法来管理和查询目录，例如设置当前目录、列举目录中的文件和子目录、创建和删除目录等。QDir 使得复杂的文件系统操作变得简单且高效，同时保证跨平台的兼容性。
QDir 的操作基于字符串路径，可以接受绝对路径或相对路径。此外，它支持过滤器和排序功能，可以灵活地筛选和排列目录中的内容。
QDir 的构造函数和常用成员函数
构造函数
1. 默认构造函数
函数原型：
QDir();
作用：
创建一个表示当前工作目录的 QDir 对象。
示例代码：
QDir dir; qDebug() << "Current directory:" << dir.path();
2. 指定路径的构造函数
函数原型：
QDir(const QString &path);
作用：
创建一个表示指定路径的 QDir 对象。
参数：
path：要表示的目录路径。
示例代码：
QDir dir("/home/user/documents");
qDebug() << "Directory path:" << dir.path();常用成员函数
1. exists
函数原型：
bool exists() const; bool exists(const QString &name) const;
作用：
检查目录或指定文件是否存在。
参数：
（无参数）检查当前目录是否存在。name：文件或子目录的名称，检查其是否存在。
返回值：
如果存在，返回 true；否则返回 false。
示例代码：
QDir dir("/home/user/documents");
if (dir.exists()) {
qDebug() << "Directory exists.";
}
if (dir.exists("file.txt")) {
qDebug() << "File exists in the directory.";
}2. mkpath
函数原型：
bool mkpath(const QString &path) const;
作用：
创建指定路径的所有父级目录（递归创建目录）。
参数：
path：要创建的路径。
返回值：
如果成功创建目录，返回 true；否则返回 false。
示例代码：
QDir dir;
if (dir.mkpath("/home/user/new_folder/sub_folder")) {
qDebug() << "Directories created successfully.";
}3. rmpath
函数原型：
bool rmpath(const QString &path) const;
作用：
删除指定路径的空目录。
参数：
path：要删除的路径。
返回值：
如果成功删除目录，返回 true；否则返回 false。
示例代码：
QDir dir;
if (dir.rmpath("/home/user/new_folder/sub_folder")) {
qDebug() << "Directory removed successfully.";
}4. setPath
函数原型：
void setPath(const QString &path);
作用：
设置 QDir 对象表示的路径。
参数：
path：要设置的路径。
示例代码：
QDir dir;
dir.setPath("/home/user/documents");
qDebug() << "Directory path set to:" << dir.path();5. entryList
函数原型：
QStringList entryList(const QStringList &nameFilters = QStringList(),
Filters filters = NoFilter,
SortFlags sort = NoSort) const;作用：
获取目录中符合条件的文件和子目录列表。
参数：
nameFilters：文件名过滤器（例如*.txt）。filters：过滤选项（如QDir::Files,QDir::Dirs等）。sort：排序选项（如QDir::Name,QDir::Time等）。
返回值：
返回一个字符串列表，包含符合条件的文件和子目录名称。
示例代码：
QDir dir("/home/user/documents");
QStringList filters;
filters << "*.txt" << "*.docx";
QStringList files = dir.entryList(filters, QDir::Files);
qDebug() << "Text and doc files:" << files;6. rename
函数原型：
bool rename(const QString &oldName, const QString &newName);
作用：
重命名文件或子目录。
参数：
oldName：旧文件或目录的名称。newName：新的文件或目录的名称。
返回值：
如果成功重命名，返回 true；否则返回 false。
示例代码：
QDir dir("/home/user/documents");
if (dir.rename("old_file.txt", "new_file.txt")) {
qDebug() << "File renamed successfully.";
}7. absolutePath 和 absoluteFilePath
函数原型：
QString absolutePath() const; QString absoluteFilePath(const QString &fileName) const;
作用：
获取当前目录的绝对路径或文件的绝对路径。
参数：
fileName：文件的名称。
返回值：
返回一个字符串，表示绝对路径。
示例代码：
QDir dir("/home/user/documents");
qDebug() << "Absolute path:" << dir.absolutePath();
qDebug() << "Absolute file path:" << dir.absoluteFilePath("file.txt");完整示例代码
以下是一个完整的示例，展示如何使用 QDir 操作文件和目录：
#include <QDir>
#include <QDebug>
int main() {
// 创建 QDir 对象
QDir dir("/home/user/documents");
// 检查目录是否存在
if (!dir.exists()) {
qDebug() << "Directory does not exist.";
return -1;
}
// 创建子目录
if (dir.mkpath("new_folder/sub_folder")) {
qDebug() << "Sub-directories created.";
}
// 获取目录中的文件列表
QStringList filters;
filters << "*.txt";
QStringList files = dir.entryList(filters, QDir::Files);
qDebug() << "Text files:" << files;
// 重命名文件
if (dir.rename("old_file.txt", "new_file.txt")) {
qDebug() << "File renamed.";
}
// 清空目录
if (dir.rmpath("new_folder")) {
qDebug() << "Directory removed.";
}
return 0;
}总结
QDir 是一个功能全面且灵活的目录操作类，它让开发者能够轻松完成文件系统中的各种任务，如创建、删除、遍历目录以及重命名文件。通过支持过滤和排序，QDir 还提供了细粒度的控制能力。如果你的项目需要处理文件和目录，QDir 是一个不可或缺的工具。
到此这篇关于Qt QDir路径类的文章就介绍到这了,更多相关Qt QDir路径类内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！