Qt 中 QDir 常用函数详解

在 Qt 框架中，QDir 类提供了强大的功能来处理目录和文件路径。无论是导航文件系统、过滤文件，还是获取路径的详细信息，QDir 都为开发者提供了一系列便捷的函数。我们详细探讨一些常用的 QDir 函数，包括 absoluteFilePath、absolutePath、canonicalPath、dirName、entryInfoList 和 entryList。

1. QString absoluteFilePath(const QString &fileName) const

absoluteFilePath 函数返回指定文件的绝对路径。这意味着无论你传入的是相对路径还是文件名，它都会返回从当前目录起的完整路径。

示例：

QDir dir("/home/user/documents");
QString absFilePath = dir.absoluteFilePath("example.txt");
// absFilePath = "/home/user/documents/example.txt"

在这个例子中，无论 example.txt 是在当前目录还是通过相对路径指定，absoluteFilePath 都会返回完整的绝对路径。

2. QString absolutePath() const

absolutePath 函数返回当前 QDir 对象所表示目录的绝对路径。它不包括文件名，只返回目录路径。

示例：

QDir dir("/home/user/documents");
QString absPath = dir.absolutePath();
// absPath = "/home/user/documents"

这个函数非常适合当你需要知道当前目录的完整路径时使用。

3. QString canonicalPath() const

canonicalPath 函数返回当前目录的规范路径。如果路径中包含符号链接（symlink），它会解析这些链接并返回实际的路径。

示例：

QDir dir("/home/user/documents/../downloads");
QString canPath = dir.canonicalPath();
// canPath = "/home/user/downloads"

这里，canonicalPath 函数会去除路径中的相对引用（如 ..）并返回实际路径。

4. QString dirName() const

dirName 函数返回当前目录的名称，不包含路径信息。换句话说，它只返回目录路径中的最后一个部分。

示例：

QDir dir("/home/user/documents");
QString dirName = dir.dirName();
// dirName = "documents"

这个函数在你只想获取目录名而不关心路径的情况下非常有用。

5. QFileInfoList entryInfoList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

entryInfoList 函数返回一个 QFileInfoList，其中包含当前目录中与指定过滤器匹配的文件和目录的信息。

示例：

QDir dir("/home/user/documents");
QFileInfoList fileList = dir.entryInfoList(QStringList() << "*.txt", QDir::Files, QDir::Name);
// fileList 包含了所有以 `.txt` 结尾的文件，并按名称排序

这个函数允许你通过指定文件名过滤器、类型过滤器和排序方式来获取符合条件的文件和目录列表。

6. QStringList entryList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

entryList 函数与 entryInfoList 类似，但它返回的是文件名和目录名的列表，而不是 QFileInfo 对象的列表。

示例：

QDir dir("/home/user/documents");
QStringList fileList = dir.entryList(QStringList() << "*.txt", QDir::Files, QDir::Name);
// fileList 包含了所有以 `.txt` 结尾的文件名，并按名称排序

这个函数适用于当你只需要文件名或目录名，而不需要文件的详细信息时。

结论

QDir 类提供的这些函数能够极大地简化文件和目录的管理。无论你是想获取文件的绝对路径，还是想筛选出特定类型的文件，这些函数都能满足你的需求。