详解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 是一个不可或缺的工具。
原文地址：https://blog.csdn.net/m0_62599305/article/details/144002464
免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！