QDir 类 -属性详解_qdir qdir::filter

提示：写完文章后，目录可以自动生成，如何生成可参考右边的帮助文档

---

概述

我们知道 QFileInfo 类是文件信息类，其用法参考《QFileInfo 类 - 文件信息类》。那么本文讲解目录信息类 QDir，用于获取有关目录的信息

函数详解

初始化

构造函数
    QDir(const QDir &dir)
    QDir(const QString &path = QString())
    QDir(const QString &path, const QString &nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)
指定目录
    QString path() const
    void setPath(const QString &path)
指定名称过滤器
    QStringList nameFilters() const
    void setNameFilters(const QStringList &nameFilters)
指定排序
    QDir::SortFlags sorting() const
    void setSorting(QDir::SortFlags      sort)
指定类型过滤器
    QDir::Filters filter() const
    void setFilter(QDir::Filters filters)
    [static]bool match(const QString &filter, const QString &fileName)
    [static]bool match(const QStringList &filters, const QString &fileName)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

要了解 QDir 类，首先肯定是这个类的构建方法。一般就是把目录地址传给构造函数即可，但这里我们来讲下第三个构造函数中各参数的意义。一共4各参数，分别为 path（路径信息）、nameFilter（名称过滤）、sort（排序规则）、filters（类型过滤）。

关于名称过滤，首先要知道生活中我们用过滤和屏蔽来筛选结果，而设置了过滤就意味着谁能通过。既然 QDir 类是目录信息类，那我肯定要知道该目录下有哪些文件、文件夹，所以在这里设置好后在调用 entryList()、entryInfoList() 时就会只显示你设置的过滤词。例如我设置了“*.cpp”".h"，那么调用 entryList() 后只返回扩展名为 cpp 和 h 的文件，其他都不显示。
关于排序规则，也是指定了返回目录信息的先后顺序，有的按名称排序，有的按时间排序，具体排序规则参看下图。可以组合起来用。

关于类型过滤，作用和名称过滤是类似的，只不过是按照类型来过滤，具体类型如下图。

关于 match()，两个静态函数可以判断 fileName 是否符合 filter 规则，其中 filter 是通配符表达式

目录信息

目录名称
    QString dirName() const
是否存在
    bool exists() const
    bool exists(const QString &name) const
判断
    bool isAbsolute() const
    [static]bool isAbsolutePath(const QString &path)
    bool isRelative() const
    [static]bool isRelativePath(const QString &path)
    bool isEmpty(QDir::Filters filters = Filters(AllEntries | NoDotAndDotDot)) const
    bool isRoot() const
    bool isReadable() const
目录内容
    uint count() const
    QStringList entryList(......) const
    QFileInfoList entryInfoList(...) const
目录中的文件路径
    QString filePath(const QString &fileName) const
    QString absoluteFilePath(const QString &fileName) const
    QString relativeFilePath(const QString &fileName) const
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

关于 dirName()，就是返回目录的名称，比如 QDir("/home/project")，那么返回值就是“project”。

关于 isAbsolute() 和 isAbsolutePath()，这两个函数的效果是一样的，区别在于是否是静态函数。同理，isRelative() 和 isRelativePath() 也是一样的。

关于 isEmpty()，就是判断目录中是否有文件或者文件夹。当然在 Linux 系统中，任何一个目录都是有‘.’和‘…’的，所以根据需要设定好 filters。

操作目录

创建
    bool mkdir(const QString &dirName) const
    bool mkpath(const QString &dirPath) const
重命名
    bool rename(const QString &oldName, const QString &newName)
删除 
    删除目录：bool rmdir(const QString &dirName) const
    删除路径：bool rmpath(const QString &dirPath) const
    删除文件：bool remove(const QString &fileName)
    全部删除：bool removeRecursively()
更改
    bool cd(const QString &dirName)
    bool cdUp()
1
2
3
4
5
6
7
8
9
10
11
12
13

关于创建目录，mkdir() 就直接在执行程序所在目录中创建一个子目录，只有一个哦。而 mkpath() 创建的目录，其父目录们也会被创建。举个例子，我要在当前目录下创建一个 folderA 目录，在 其中再创建一个 folderB 目录。如果用 mkdir() 就需要写两遍，而用 mkpath() 只需要执行 mkpath(“folderA/folderB”) 即可。

程序目录和特殊目录

程序目录 
    [static]QDir current()
    [static]QString currentPath()
    [static]bool setCurrent(const QString &path)
特殊目录
    系统根目录列表
        [static]QFileInfoList drives()
    根目录
        根目录：[static]QDir root()
        根路径：[static]QString rootPath()
    临时目录
        [static]QDir temp()
        [static]QString tempPath()
    系统主目录
        [static]QDir home()
        [static]QString homePath()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

关于程序目录，三个函数都是获取可执行程序所在的目录，而不是 QDir 中的目录。

关于 drives()，这个静态函数可了不得，能获得电脑里所有的盘符，比如“C:\”、“D:\”。Linux 只会返回个“/”。

路径相关

绝对路径：QString absolutePath() const
转成绝对路径：bool makeAbsolute()
规范路径：QString canonicalPath() const
搜索前缀功能
    获取：[static]QStringList searchPaths(const QString &prefix)
    增加：[static]void addSearchPath(const QString &prefix, const QString &path)
    设置：void setSearchPaths(const QString &prefix, const QStringList &searchPaths)
分隔符
    [static]QChar separator()
    [static]QChar listSeparator()
    [static]QString toNativeSeparators(const QString &pathName)
    [static]QString fromNativeSeparators(const QString &pathName)
清除前缀路径：[static]QString cleanPath(const QString &path)
1
2
3
4
5
6
7
8
9
10
11
12
13

关于“搜索前缀”功能，自从 Qt 4.3 引入以来，我相信用这个功能的人是极少的。这个功能其实很强大，它是干吗用的呢？这样说吧，假如某个类型的文件都在一个目录存放，而这个目录的绝对路径特别长，此时用“搜索前缀”功能就会方便很多。举个例子，QDir::setSearchPaths(“doc”, “c:/My Documents”)，这样的一句话表明“c:/My Documents”可以用“doc”来替换。那么我要用的时候可以这样：QFile file(“docs:test.txt”)，展开来就是“c:/My Documents/test.txt”。

关于分隔符，我们知道 Windows 下是‘\’而 Linux 下是‘/’，separator() 就是用来返回分隔符用的。listSeparator() 同样在 Windows 下是‘；’而 Linux 下是‘：’。剩下的 toNativeSeparators() 和 fromNativeSeparators() 两个函数也是处理分隔符的，我们的 Qt 在写路径的时候统一用‘/’，但想转成 Windows 下的‘\’就可以用 to… 函数

宏

void Q_CLEANUP_RESOURCE(name)
void Q_INIT_RESOURCE(name)
有人很好奇，为啥资源系统相关的宏会在 QDir 里出现，其实这和上文的“搜索前缀”功能类似。因为我们用 Qt 资源系统时都是“:/image/main.png”这种样子的，它既不是绝对路径也不是相对路径。但是‘