102-数据读写和文件管理-数据读写基本类-路径管理QDir_qdir如何使用

路径管理QDir

路径管理QDir 用于管理路径和文件它的一些功能与QFilenfo的功能相同。

用QDir创建路径管理对象的方法如下,其中:path 是路径;nameFilter 是名称过滤器;sort 是枚举类型QDirSortFlag,指定排序规则;filters 是枚举类型QDirFilter,是属性过滤器

from PySide6.QtCore import QDir

QDir(arg__1: Union[PySide6.QtCore.QDir,str])-> None
QDir(path: Union[str,bytes,os.PathLike,NoneType])-> None
QDir(path: Union[str,bytes,os.PathLike],nameFilter: str,sort: PySide6.QtCore.QDir.SortFlag = Instance(QDir.SortFlags(QDir.SortFlag.Name | QDir.SortFlag.IgnoreCase)),filter: PySide6.QtCore.QDir.Filter = Instance(QDir.Filter.AllEntries))-> None
1
2
3
4
5

路径管理QDir的说明

QDir用于操作路径名、访问有关路径和文件的信息以及操作底层文件系统。它还可以用于访问Qt的资源系统。
Qt使用"/“作为通用目录分隔符,其方式与URL中将”/“用作路径分隔符的方式相同。如果您总是使用”/"作为目录分隔符,Qt将转换您的路径以符合底层操作系统。
QDir可以使用相对路径或绝对路径指向文件。绝对路径以目录分隔符开头(在Windows下,可以选择在前面加上驱动器规范)。相对文件名以目录名或文件名开头,并指定相对于当前目录的路径。
绝对路径示例:

QDir("/home/user/Documents")
QDir("C:/Users")
1
2

在Windows上,当用于访问文件时,上面的第二个示例将被转换为C:\Users。
相对路径示例:

QDir("images/landscape.png")
1

您可以使用isRelative()或isAbsolute()函数来检查QDir使用的是相对文件路径还是绝对文件路径。调用makeAbsolute()将相对QDir转换为绝对QDir。

以冒号(:)开头的路径总是被认为是绝对的,因为它们表示一个QResource。

导航和目录操作

可以使用path()函数获取目录的路径,并使用setPath()函数设置新的路径。通过调用absolutePath()可以找到目录的绝对路径。
使用dirName()函数可以找到目录的名称。这通常返回指定目录位置的绝对路径中的最后一个元素。但是,如果QDir表示当前目录,它也可以返回"."。

QDir("Documents/Letters/Applications").dirName()//"Applications"
QDir().dirName()//"."
1
2

目录的路径也可以通过cd()和cdUp()函数更改,这两个函数的操作方式与熟悉的shell命令类似。当使用现有目录的名称调用cd()时,QDir对象会更改目录,使其代表该目录。函数的作用是更改QDir对象的目录,使其引用其父目录；即cd(“…”)相当于cdUp()。
目录可以用mkdir()创建,用rename()重命名,用rmdir()删除。
您可以使用exists()测试给定名称目录的存在性,并且可以使用isReadable()、isAbsolute()、isRelative()和isRoot()来测试目录的属性。
函数的作用是从磁盘中重新读取目录的数据。

文件和目录内容

目录包含许多条目,表示文件、目录和符号链接。目录中的项数由count()返回。可以使用entryList()获取目录中所有条目名称的字符串列表。如果需要有关每个条目的信息,请使用entryInfoList()获取QFileInfo对象的列表。
目录中的文件和目录的路径可以使用filePath()和absoluteFilePath()构造。filePath()函数返回指定文件或目录相对于QDir对象路径的路径；absoluteFilePath()返回指定文件或目录的绝对路径。这两个函数都不检查文件或目录的存在；它们只构建路径。

directory = QDir("Documents/Letters")
path = directory.filePath("contents.txt")
absolutePath = directory.absoluteFilePath("contents.txt")
1
2
3

可以使用remove()函数删除文件。目录不能以与文件相同的方式删除；使用rmdir()将其删除。
通过对QDir对象应用筛选器,可以减少entryList()和entryInfoList()返回的条目数量。您可以应用名称过滤器来指定文件名需要匹配的带有通配符的模式、选择条目属性并可以区分文件和目录的属性过滤器,以及排序顺序。
名称筛选器是传递给setNameFilters()的字符串列表。属性过滤器由过滤器的位或组合组成,这些过滤器是在调用setFilter()时指定的。排序顺序是使用setSorting()和SortFlags的按位或组合指定的。
您可以使用match()函数测试文件名是否与过滤器匹配。
在调用entryList()和entryInfoList()以覆盖先前定义的行为时,还可以指定筛选和排序顺序标志。

当前目录和其他特殊路径

通过返回QDir对象的许多静态函数提供了对一些常用目录的访问。这些函数也有相应的返回字符串的函数:

setCurrent()静态函数也可以用于设置应用程序的工作目录。
如果要查找包含应用程序可执行文件的目录,请参阅applicationDirPath()。
drives()静态函数为每个包含文件系统的设备提供根目录列表。在Unix系统上,它返回一个包含单个根目录"/"的列表；在Windows上,根据用户系统的配置,列表通常包含C:/,可能还包含D:/等其他驱动器号。

路径操作和字符串

使用canonicalPath()函数,可以将包含引用路径中该点当前目录的".“元素、引用父目录的”…“元素和符号链接的路径简化为规范形式。
还可以通过使用cleanPath()删除多余的”/“和”…"元素来简化路径。
有时需要能够在用户平台的本机表示中显示路径。静态toNativeSeparators()函数返回指定路径的副本,其中每个目录分隔符都被底层操作系统的适当分隔符所取代。

示例

检查目录是否存在:

dir = QDir("example")
if not dir.exists():
    qWarning("Cannot find the example directory")
1
2
3

也可以使用其中一个静态便利函数exists()或exists)。
遍历目录并读取文件:

dir = QDir.root()#"/"()
if not dir.cd("tmp"): #"/tmp"
    qWarning("Cannot find the \"/tmp\"directory")
else:
    file = QFile(dir.filePath("ex1.txt"))
    if not file.open(QIODevice.ReadWrite):
        qWarning("Cannot create the file %s",file.name())
1
2
3
4
5
6
7

一个程序,列出当前目录中的所有文件(不包括符号链接),按大小排序,最小优先:

from PySide6.QtCore import QDir

if __name__ =="__main__":

    app = QCoreApplication(argc,argv)
    dir = QDir()
    dir.setFilter(QDir.Files | QDir.Hidden | QDir.NoSymLinks)
    dir.setSorting(QDir.Size | QDir.Reversed)
    list = dir.entryInfoList()
    print("Bytes Filename")
    for i in range(0,list.size()):
        fileInfo = list.at(i)
        print(qPrintable(QString("%1 %2").arg(fileInfo.size(),10))
                                                .arg(fileInfo.fileName()))
        std::cout << std::endl

    return 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

平台特定问题

在Android上,处理内容URI时会有一些限制:

• 通过QFileDialog提示用户可能需要访问权限,该对话框实现了Android的本地文件选择器。
• 旨在遵循Scoped存储指南,例如使用特定于应用程序的目录,而不是其他公共外部目录。有关详细信息,另请参阅存储最佳做法。
• 由于Qt API(例如QFile)的设计,不可能将后一种API与Android的MediaStore API完全集成。

路径管理QDir的常用方法

QDir的常用方法如表所示,主要方法介绍如下

• 可以在创建路径对象时指定路径,也可以用setPath(str)方法指定路径用path()方法获取路径。

• 在创建路径对象时,指定的过滤器、排序规则用于获取路径下的文件和子路径。

  • 获取路径下的文件和子路径的方法有:

    • entryInfoList(filters,sort)

    • entryInfoList(Sequence[nameFilters],filters,sort)

    • entryList(filters,sort)

    • entryList[str]和entryList(Sequence[nameFilters],filters,sort)

    • 其中属性过滤器 filters 可以取PySide6.QtCore.QDir.Filter

  (继承enum.Flag)此枚举描述了QDir可用的筛选选项；例如entryList()和entryInfoList()。过滤器值是通过使用逐位OR运算符组合以下列表中的值来指定的

    使用Filter枚举值筛选文件和目录列表的函数将包括指向文件和目录的符号链接,除非您设置了NoSymLinks值。
    默认构造的QDir不会根据文件的权限筛选出文件,因此entryList()和entryInfoList()将返回可读、可写、可执行或三者的任何组合的所有文件。这使得默认设置易于编写,同时也很有用。
    例如,通过设置Readable、Writable和Files标志,可以列出应用程序具有读取访问权限、写入访问权限或两者兼有的所有文件。如果Dirs和Drives标志也包含在此组合中,则可以列出所有驱动器、目录、应用程序可以读取、写入或执行的所有文件,以及指向这些文件/目录的符号链接。
    要检索目录的权限,请使用entryInfoList()函数获取关联的QFileInfo对象,然后使用permissions()获取每个文件的权限和所有权。
    
    | Constant            | Description                                                  |
    | ------------------- | ------------------------------------------------------------ |
    | QDir.Dirs           | 列出与筛选器匹配的目录。                                     |
    | QDir.AllDirs        | 列出所有目录；即不将过滤器应用于目录名。                     |
    | QDir.Files          | 列出文件。                                                   |
    | QDir.Drives         | 列出磁盘驱动器(在Unix下被忽略)。                           |
    | QDir.NoSymLinks     | 不要列出符号链接(被不支持符号链接的操作系统忽略)。         |
    | QDir.NoDotAndDotDot | 不要列出特殊条目"."和".."。                                  |
    | QDir.NoDot          | 不要列出特殊条目"."。                                        |
    | QDir.NoDotDot       | 不要列出特殊条目".."。                                       |
    | QDir.AllEntries     | 列出目录、文件、驱动器和符号链接(除非指定"系统",否则不会列出断开的符号链接)。 |
    | QDir.Readable       | 列出应用程序具有读取访问权限的文件。Readable值需要与Dirs或Files组合使用。 |
    | QDir.Writable       | 列出应用程序具有写访问权限的文件。"可写入"值需要与"目录"或"文件"组合使用。 |
    | QDir.Executable     | 列出应用程序具有执行访问权限的文件。Executable值需要与Dirs或Files组合使用。 |
    | QDir.Modified       | 仅列出已修改的文件(在Unix上被忽略)。                       |
    | QDir.Hidden         | 列出隐藏文件(在Unix上,以"."开头的文件)。                  |
    | QDir.System         | 列出系统文件(在Unix上,包括FIFO、套接字和设备文件；在Windows上,包括.lnk文件)|
    | QDir.CaseSensitive  | 过滤器应区分大小写。                                         |
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23

  ​

  ​

  • 排序规则 sort 可以取PySide6.QtCore.QDir.SortFlag

  (继承enum.Flag)此枚举描述了QDir可用的排序选项,例如entryList()和entryInfoList()。排序值是通过将以下列表中的值进行"或"运算来指定的:

  只能指定前四个选项中的一个。如果同时指定DirsFirst和Reversed,则目录仍然放在第一位,但顺序相反；文件将再次以相反的顺序列在目录之后。
  
  | Constant         | Description                          |
  | ---------------- | ------------------------------------ |
  | QDir.Name        | 按名称排序。                         |
  | QDir.Time        | 按时间排序(修改时间)。             |
  | QDir.Size        | 按文件大小排序。                     |
  | QDir.Type        | 按文件类型(扩展名)排序。           |
  | QDir.Unsorted    | 不要排序。                           |
  | QDir.NoSort      | 默认情况下不排序。                   |
  | QDir.DirsFirst   | 先放目录,然后放文件。               |
  | QDir.DirsLast    | 先放文件,然后放目录。               |
  | QDir.Reversed    | 颠倒排序顺序。                       |
  | QDir.IgnoreCase  | 区分大小写排序。                     |
  | QDir.LocaleAware | 使用当前区域设置对项目进行适当排序。 |
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15

  ​

  • 名称过滤器、属性过滤器和排序规则也可以分别用setNameFilters(Sequence[str])、setFilter(QDir,Filter)和 setSorting(QDir.SortFlag)方法设置

• 用setCurrent(str)方法设置应用程序当前的工作路径; 用currentPath()方法获取应用程序的当前绝对工作路径。

• 用mkdir(str)方法创建子路径;

  • 用mkpath(str)方法创建多级路径;
  • 用rmdir(str)方法移除子路径,
  • 在路径为空的情况下,用rmpath(str)方法移除多级路径

路径管理Dir的应用实例

下面的程序,单击"文件"菜单下的选择路径,从路径选择对话框中选择一个路径后,将列出该路径下所有文件的文件名、文件大小创建日期和修改日期信息。

# -*- coding: UTF-8 -*-
# File date: Hi_2023/3/11 17:39
# File_name: 06-路径管理Dir的应用实例.py


from PySide6.QtWidgets import QApplication,QMainWindow,QPlainTextEdit,QFileDialog
from PySide6.QtCore import QDir
import sys


class MyWindow(QMainWindow):
    def __init__(self,parent=None):
        super().__init__(parent)

        self.resize(800,600)
        self.setupUI()# 界面

    def setupUI(self):  # 界面建立
        self.plainText = QPlainTextEdit()
        self.setCentralWidget(self.plainText)
        self.status = self.statusBar()
        self.menubar = self.menuBar()# 菜单栏

        self.file = self.menubar.addMenu('文件')# 文件菜单
        action_dir = self.file.addAction('选择路径')# 动作
        action_dir.triggered.connect(self.action_dir_triggered)

        self.file.addSeparator()

        action_close = self.file.addAction('关闭')
        action_close.triggered.connect(self.close)

    def action_dir_triggered(self):
        path = QFileDialog.getExistingDirectory(self,caption="选择路径")
        dir = QDir(path)
        dir.setFilter(QDir.Files)# 只显示文件
        if dir.exists(path):
            template ="文件名:{} 文件大小:{}字节  创建日:{}   修改日期:{}"
            fileInfo_list = dir.entryInfoList()# 获取文件信息列表
            n = len(fileInfo_list)# 文件数量
            if n:  # 如果路径下有文件
                self.status.showMessage("选择的路径是:"+ dir.toNativeSeparators(path)+"该路径下有"+ str(n)+"个文件")
                self.plainText.clear()
                self.plainText.appendPlainText(dir.toNativeSeparators(path)+"下的文件如下:")
                for info in fileInfo_list:
                    string = template.format(info.fileName(),info.size(),info.birthTime().toString(),info.lastModified().toString())
                    self.plainText.appendPlainText(string)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MyWindow()

    win.show()
    sys.exit(app.exec())

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56