# QDir Class Reference ## [[QtCore](index.htm) module] 歸QDir類提供了訪問目錄結構和它們的內容。[More...](#details) ### Types * `enum Filter { Dirs, Files, Drives, NoSymLinks, ..., NoDotDot }` * `class **[Filters](index.htm)**` * `enum SortFlag { Name, Time, Size, Unsorted, ..., NoSort }` * `class **[SortFlags](index.htm)**` ### Methods * `__init__ (self, QDir)` * `__init__ (self, QString?path?=?QString())` * `__init__ (self, QString?path, QString?nameFilter, SortFlags?sort?=?QDir.Name|QDir.IgnoreCase, Filters?filters?=?QDir.AllEntries)` * `QString absoluteFilePath (self, QString?fileName)` * `QString absolutePath (self)` * `QString canonicalPath (self)` * `bool cd (self, QString?dirName)` * `bool cdUp (self)` * `int count (self)` * `QString dirName (self)` * `list-of-QFileInfo entryInfoList (self, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort)` * `list-of-QFileInfo entryInfoList (self, QStringList?nameFilters, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort)` * `QStringList entryList (self, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort)` * `QStringList entryList (self, QStringList?nameFilters, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort)` * `bool exists (self)` * `bool exists (self, QString?name)` * `QString filePath (self, QString?fileName)` * `Filters filter (self)` * `bool isAbsolute (self)` * `bool isReadable (self)` * `bool isRelative (self)` * `bool isRoot (self)` * `bool makeAbsolute (self)` * `bool mkdir (self, QString?dirName)` * `bool mkpath (self, QString?dirPath)` * `QStringList nameFilters (self)` * `QString path (self)` * `refresh (self)` * `QString relativeFilePath (self, QString?fileName)` * `bool remove (self, QString?fileName)` * `bool rename (self, QString?oldName, QString?newName)` * `bool rmdir (self, QString?dirName)` * `bool rmpath (self, QString?dirPath)` * `setFilter (self, Filters?filter)` * `setNameFilters (self, QStringList?nameFilters)` * `setPath (self, QString?path)` * `setSorting (self, SortFlags?sort)` * `SortFlags sorting (self)` ### Static Methods * `addResourceSearchPath (QString?path)` * `addSearchPath (QString?prefix, QString?path)` * `QString cleanPath (QString?path)` * `QString convertSeparators (QString?pathName)` * `QDir current ()` * `QString currentPath ()` * `list-of-QFileInfo drives ()` * `QString fromNativeSeparators (QString?pathName)` * `QDir home ()` * `QString homePath ()` * `bool isAbsolutePath (QString?path)` * `bool isRelativePath (QString?path)` * `bool match (QStringList?filters, QString?fileName)` * `bool match (QString?filter, QString?fileName)` * `QStringList nameFiltersFromString (QString?nameFilter)` * `QDir root ()` * `QString rootPath ()` * `QStringList searchPaths (QString?prefix)` * `QChar separator ()` * `bool setCurrent (QString?path)` * `setSearchPaths (QString?prefix, QStringList?searchPaths)` * `QDir temp ()` * `QString tempPath ()` * `QString toNativeSeparators (QString?pathName)` ### Special Methods * `int __contains__ (self, QString)` * `bool __eq__ (self, QDir?dir)` * `QString __getitem__ (self, int)` * `QStringList __getitem__ (self, slice)` * `__len__ (self)` * `bool __ne__ (self, QDir?dir)` * * * ## Detailed Description 歸QDir類提供了訪問目錄結構和它們的內容。 一個的QDir用來操作路徑名稱，訪問有關的路徑和文件的信息，并操作底層文件系統。它也可以被用來訪問Qt的[resource system](index.htm#resource-system)。 Qt使用“/”作為以同樣的方式， “ / ”作為URL中的路徑分隔符的通用目錄分隔符。如果你總是使用“ / ”作為目錄分隔符， Qt將會把你的路徑，以符合底層操作系統。 一個的QDir可以指向使用相對或絕對路徑的文件。絕對路徑開頭的目錄分隔符（前面可以在Windows下的驅動器規格） 。相對文件名開頭的目錄名或文件名和路徑指定一個相對于當前目錄。 絕對路徑的例子： ``` QDir("/home/user/Documents") QDir("C:/Documents and Settings") ``` 在Windows上，上述第二個例子將被轉換為`C:\Documents and Settings`用于訪問文件時。 相對路徑的例子： ``` QDir("../img/landscape.png") ``` 您可以使用[isRelative](qdir.html#isRelative)（）或[isAbsolute](qdir.html#isAbsolute)（ ）函數，如果一個的QDir使用相對或絕對文件路徑來檢查。通話[makeAbsolute](qdir.html#makeAbsolute)（ ）到一個相對的QDir轉化為絕對的。 ### Navigation and Directory Operations 一個目錄的路徑可以用得到[path](qdir.html#pathx)（ ）函數，并設置了一個新的路徑[setPath](qdir.html#setPath)（）函數。的絕對路徑的目錄是通過調用發現[absolutePath](qdir.html#absolutePath)（ ） 。 目錄的名稱使用中發現的[dirName](qdir.html#dirName)（）函數。這通常返回指定的目錄的位置的絕對路徑中的最后一個元素。然而，它也可以返回“ 。 ”如果的QDir表示當前目錄。 ``` QDir("Documents/Letters/Applications").dirName() // "Applications" QDir().dirName() // "." ``` 對目錄的路徑，也可以用改變[cd](qdir.html#cd)（）和[cdUp](qdir.html#cdUp)這兩者（ ）函數，操作就像熟悉shell命令。何時[cd](qdir.html#cd)（ ）被調用現有的目錄的名稱，歸QDir對象改變目錄，它表示該目錄代替。該[cdUp](qdir.html#cdUp)（ ）函數改變的QDir對象的目錄，以便它指的是它的父目錄，即CD（ “..” ）等價于[cdUp](qdir.html#cdUp)（ ） 。 目錄可以使用以下命令創建[mkdir](qdir.html#mkdir)（ ） ，重命名[rename](qdir.html#rename)（ ）中，用去除[rmdir](qdir.html#rmdir)（ ） 。 您可以通過使用測試具有給定名稱的目錄存在[exists](qdir.html#exists)（ ）和目錄的屬性可以與被測試[isReadable](qdir.html#isReadable)（ ）[isAbsolute](qdir.html#isAbsolute)（ ）[isRelative](qdir.html#isRelative)（）和[isRoot](qdir.html#isRoot)（ ） 。 該[refresh](qdir.html#refresh)（ ）函數再從磁盤讀取該目錄的數據。 ### Files and Directory Contents 目錄包含多個條目，代表文件，目錄和符號鏈接。條目中的目錄數被返回[count](qdir.html#count)（ ） 。可以得到在一個目錄中的所有條目的名稱的字符串列表[entryList](qdir.html#entryList)（ ） 。如果您需要了解每一個項目的信息，請使用[entryInfoList](qdir.html#entryInfoList)（）獲得的一個列表[QFileInfo](qfileinfo.html)對象。 路徑文件和一個目錄下的目錄可以使用構造[filePath](qdir.html#filePath)（）和[absoluteFilePath](qdir.html#absoluteFilePath)（ ） 。該[filePath](qdir.html#filePath)（ ）函數返回一個路徑指定的文件或目錄相對的QDir對象的路徑;[absoluteFilePath](qdir.html#absoluteFilePath)（ ）返回一個絕對路徑指定的文件或目錄。無論這些函數會檢查文件或目錄是否存在，他們只是構建路徑。 ``` QDir directory("Documents/Letters"); [QString](qstring.html) path = directory.filePath("contents.txt"); [QString](qstring.html) absolutePath = directory.absoluteFilePath("contents.txt"); ``` 文件可以通過使用可移除的[remove](qdir.html#remove)（）函數。目錄不能以同樣的方式作為文件被刪除;使用[rmdir](qdir.html#rmdir)（）來代替刪除它們。 它能夠減少由返回的條目的數量[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ）通過應用過濾器到的QDir對象。你可以申請一個名字過濾器來指定使用通配符模式的文件名需要匹配，屬性過濾器的選擇項的屬性和文件和目錄可以區分，和排序順序。 名稱過濾器的字符串傳遞給該列表[setNameFilters](qdir.html#setNameFilters)（ ） 。屬性過濾器由一個過濾器按位或組合，而這些都是調用時指定[setFilter](qdir.html#setFilter)（ ） 。使用指定的排序順序[setSorting](qdir.html#setSorting)（ ）用按位或組合[SortFlags](qdir.html#SortFlag-enum)。 你可以測試一下，看有沒有使用的文件名匹配的過濾器[match](qdir.html#match)（）函數。 篩選和排序順序標志也可能被調用時指定[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（）以復蓋先前定義的行為。 ### The Current Directory and Other Special Paths 訪問一些常見的目錄設置有若干靜態函數返回的QDir對象。還有這些返回字符串對應的功能： | QDir | [QString](qstring.html) | Return Value | | --- | --- | --- | | [current](qdir.html#current)() | [currentPath](qdir.html#currentPath)() | The application's working directory | | [home](qdir.html#home)() | [homePath](qdir.html#homePath)() | The user's home directory | | [root](qdir.html#root)() | [rootPath](qdir.html#rootPath)() | The root directory | | [temp](qdir.html#temp)() | [tempPath](qdir.html#tempPath)() | The system's temporary directory | 該[setCurrent](qdir.html#setCurrent)（ ）靜態函數也可以用于設置應用程序的工作目錄。 如果你想找到包含應用程序的可執行文件的目錄，請參見[QCoreApplication.applicationDirPath](qcoreapplication.html#applicationDirPath)（ ） 。 該[drives](qdir.html#drives)（）靜態函數提供為每個包含一個歸檔系統設備根目錄的列表。在Unix系統中，這會返回一個包含單個根目錄“ / ”的列表;在Windows上的列表通常包含`C:/`，以及其他可能的驅動器號，如`D:/`，這取決于用戶的系統的配置。 ### Path Manipulation and Strings 路徑包含“ 。 ”引用當前目錄在路徑點的元素， “..”元素引用的父目錄和符號鏈接可以使用減少到規范形式的[canonicalPath](qdir.html#canonicalPath)（）函數。 路徑也可以通過使用簡化的[cleanPath](qdir.html#cleanPath)（）刪除多馀的“ / ”和“..”元素。 它有時需要能夠顯示在本機表示一個路徑為用戶的平臺。靜[toNativeSeparators](qdir.html#toNativeSeparators)（ ）函數返回，其中每個目錄分隔符替換為適當的分隔符底層操作系統的指定路徑的一個副本。 ### Examples 檢查目錄是否存在： ``` QDir dir("example"); if (!dir.exists()) qWarning("Cannot find the example directory"); ``` （我們也可以使用靜態的便利功能[QFile.exists](qfile.html#exists)（ ） 。 ） 遍歷目錄和讀取文件： ``` QDir dir = QDir.root(); // "/" if (!dir.cd("tmp")) { // "/tmp" qWarning("Cannot find the \"/tmp\" directory"); } else { [QFile](qfile.html) file(dir.filePath("ex1.txt")); // "/tmp/ex1.txt" if (!file.open([QIODevice](qiodevice.html).ReadWrite)) qWarning("Cannot create the file %s", file.name()); } ``` 一個程序，列出當前目錄下的所有文件（不包括符號鏈接） ，按大小排序，最小的第一： ``` #include <QDir> #include <iostream> int main(int argc, char *argv[]) { [QCoreApplication](qcoreapplication.html) app(argc, argv); QDir dir; dir.setFilter(QDir.Files | QDir.Hidden | QDir.NoSymLinks); dir.setSorting(QDir.Size | QDir.Reversed); [QFileInfoList](qfileinfo.html#QFileInfoList-typedef) list = dir.entryInfoList(); std.cout << " Bytes Filename" << std.endl; for (int i = 0; i < list.size(); ++i) { [QFileInfo](qfileinfo.html) fileInfo = list.at(i); std.cout << qPrintable([QString](qstring.html)("%1 %2").arg(fileInfo.size(), 10) .arg(fileInfo.fileName())); std.cout << std.endl; } return 0; } ``` * * * ## Type Documentation ``` QDir.Filter ``` 這個枚舉描述提供給過濾選項[QDir](qdir.html);如為[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。指定通過使用按位OR運算符下面的列表值相結合的過濾器值： | Constant | Value | Description | | --- | --- | --- | | `QDir.Dirs` | `0x001` | 相匹配的過濾器列表目錄。 | | `QDir.AllDirs` | `0x400` | 列出所有的目錄，即不過濾器不適用于目錄名。 | | `QDir.Files` | `0x002` | 列表文件。 | | `QDir.Drives` | `0x004` | 列表磁盤驅動器（在Unix下被忽略） 。 | | `QDir.NoSymLinks` | `0x008` | 不要列出符號鏈接（由不支持符號連接的操作系統忽略不計） 。 | | `QDir.NoDotAndDotDot` | `0x1000` | 不要列出特殊項目“ 。 ”和“..”。 | | `QDir.NoDot` | `0x2000` | 不要列出的特殊條目“ 。” | | `QDir.NoDotDot` | `0x4000` | 不要列出特殊的入口“..” 。 | | `QDir.AllEntries` | `Dirs &#124; Files &#124; Drives` | 列出目錄，文件，驅動器和符號鏈接（這并不列出破碎的符號鏈接，除非您指定系統） 。 | | `QDir.Readable` | `0x010` | 列表文件的應用程序有讀權限。可讀值需要與顯示目錄或文件相結合。 | | `QDir.Writable` | `0x020` | 列出文件該申請寫訪問。可寫值需要與顯示目錄或文件相結合。 | | `QDir.Executable` | `0x040` | 列出文件該應用程序具有執行權限。可執行值需要與顯示目錄或文件相結合。 | | `QDir.Modified` | `0x080` | 僅列出已修改（忽略在Unix ）文件。 | | `QDir.Hidden` | `0x100` | 列出隱藏文件（在Unix上，文件開頭的“。”） 。 | | `QDir.System` | `0x200` | 列表的系統文件（在Unix上， FIFO的，插座和設備文件都包括在內;在Windows上，`.lnk`文件都包括在內） | | `QDir.CaseSensitive` | `0x800` | 該過濾器應區分大小寫。 | 使用過濾器枚舉值來過濾文件和目錄列表的功能將包括符號鏈接文件和目錄，除非你設置NoSymLinks值。 構造一個默認的[QDir](qdir.html)不會過濾出基于其權限的文件，所以[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ）將返回一個可讀的所有文件，可寫，可執行，或三者的任意組合。這使得默認容易編寫，并在同一時間是有用的。 例如，設置`Readable`，`Writable`和`Files`標志允許該應用程序有讀權限被列出的所有文件，寫訪問或兩者兼而有之。如果`Dirs`和`Drives`標志也包含在這個組合則所有的驅動器，目錄，該應用程序可以讀，寫或執行所有文件，符號鏈接到這些文件/目錄可以上市。 檢索PERMISSONS的目錄，使用[entryInfoList](qdir.html#entryInfoList)（ ）函數來獲取相關的[QFileInfo](qfileinfo.html)對象，然后使用QFileInfo.permissons （ ）來獲取權限和所有權的每個文件。 該過濾器類型是一個typedef為[QFlags](index.htm)的\u003cfilter\u003e 。它存儲濾波值的或組合。 ``` QDir.SortFlag ``` 這個枚舉介紹可用于排序選項[QDir](qdir.html)如為[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。指定由從以下列表中的OR-ing合值的排序值： | Constant | Value | Description | | --- | --- | --- | | `QDir.Name` | `0x00` | 按名稱排序。 | | `QDir.Time` | `0x01` | 按時間排序（修改時間） 。 | | `QDir.Size` | `0x02` | 排序按文件大小。 | | `QDir.Type` | `0x80` | 排序文件類型（擴展名） 。 | | `QDir.Unsorted` | `0x03` | 不排序。 | | `QDir.NoSort` | `-1` | 沒有排序默認。 | | `QDir.DirsFirst` | `0x04` | 把該目錄，然后是文件。 | | `QDir.DirsLast` | `0x20` | 把文件先，然后是目錄。 | | `QDir.Reversed` | `0x08` | 反向排序。 | | `QDir.IgnoreCase` | `0x10` | 排序不區分大小寫。 | | `QDir.LocaleAware` | `0x40` | 適當地使用當前區域設置項進行排序。 | 您只能指定前四個中的一個。 如果同時指定DirsFirst和反轉，目錄還是把第一，但以相反的順序，該文件會以相反的順序被列出的目錄后，再次。 該SortFlags類型是一個typedef為[QFlags](index.htm)\u003cSortFlag\u003e 。它存儲SortFlag值的或組合。 * * * ## Method Documentation ``` QDir.__init__ (self, QDir) ``` 構造一個[QDir](qdir.html)對象，它是的一個副本[QDir](qdir.html)反對的目錄_dir_。 **See also** [operator=](qdir.html#operator-eq)（ ） 。 ``` QDir.__init__ (self, QString?path?=?QString()) ``` 構造一個[QDir](qdir.html)指向給定目錄_path_。如果path是空的程序的工作目錄（ “。”） ，被使用。 **See also** [currentPath](qdir.html#currentPath)（ ） 。 ``` QDir.__init__ (self, QString?path, QString?nameFilter, SortFlags?sort?=?QDir.Name|QDir.IgnoreCase, Filters?filters?=?QDir.AllEntries) ``` 構造一個[QDir](qdir.html)與路徑_path_，通過名稱使用的過濾條目_nameFilter_并且通過使用屬性_filters_。它還使用排序的名字_sort_。 默認_nameFilter_是一個空字符串，不包括什么，默認_filters_ is [AllEntries](qdir.html#Filter-enum)，這也意味著排除無關。默認_sort_ is [Name](qdir.html#SortFlag-enum)|[IgnoreCase](qdir.html#SortFlag-enum)，即按名稱排序不區分大小寫。 If _path_是一個空字符串，[QDir](qdir.html)使用“ 。 ” （當前目錄） 。如果_nameFilter_是一個空字符串，[QDir](qdir.html)使用名稱過濾器“ * ” （所有文件） 。 需要注意的是_path_不需要存在。 **See also** [exists](qdir.html#exists)（ ）[setPath](qdir.html#setPath)（ ）[setNameFilter](index.htm#setNameFilter)（ ）[setFilter](qdir.html#setFilter)（）和[setSorting](qdir.html#setSorting)（ ） 。 ``` QString QDir.absoluteFilePath (self, QString?fileName) ``` 返回目錄中的文件的絕對路徑名。是否_not_檢查文件是否確實存在于目錄，但看[exists](qdir.html#exists)（ ） 。冗馀的多個隔板或“。 ”中和“..”的目錄_fileName_不會被刪除（見[cleanPath](qdir.html#cleanPath)（））。 **See also** [relativeFilePath](qdir.html#relativeFilePath)（ ）[filePath](qdir.html#filePath)（）和[canonicalPath](qdir.html#canonicalPath)（ ） 。 ``` QString QDir.absolutePath (self) ``` 返回絕對路徑（以“ / ”或驅動器規格開始的路徑） ，其中可能包含符號鏈接，但不會包含多馀的“ 。 ” ， “..”或多個分隔符。 **See also** [setPath](qdir.html#setPath)（ ）[canonicalPath](qdir.html#canonicalPath)（ ）[exists](qdir.html#exists)（ ）[cleanPath](qdir.html#cleanPath)（ ）[dirName](qdir.html#dirName)（）和[absoluteFilePath](qdir.html#absoluteFilePath)（ ） 。 ``` QDir.addResourceSearchPath (QString?path) ``` ``` QDir.addSearchPath (QString?prefix, QString?path) ``` 添加_path_為搜索路徑_prefix_。 此功能被引入Qt的4.3 。 **See also** [setSearchPaths](qdir.html#setSearchPaths)（ ） 。 ``` QString QDir.canonicalPath (self) ``` 返回規范的路徑，即路徑沒有符號鏈接或多馀的“ 。 ”或“..”元素。 對不具有符號鏈接此功能的系統將始終返回相同的字符串[absolutePath](qdir.html#absolutePath)（ ）返回。如果規范的路徑不存在（通常是由于懸空符號鏈接） canonicalPath （ ）返回一個空字符串。 例如： ``` [QString](qstring.html) bin = "/local/bin"; // where /local/bin is a symlink to /usr/bin [QDir](qdir.html) binDir(bin); [QString](qstring.html) canonicalBin = binDir.canonicalPath(); // canonicalBin now equals "/usr/bin" [QString](qstring.html) ls = "/local/bin/ls"; // where ls is the executable "ls" [QDir](qdir.html) lsDir(ls); [QString](qstring.html) canonicalLs = lsDir.canonicalPath(); // canonicalLS now equals "/usr/bin/ls". ``` **See also** [path](qdir.html#pathx)（ ）[absolutePath](qdir.html#absolutePath)（ ）[exists](qdir.html#exists)（ ）[cleanPath](qdir.html#cleanPath)（ ）[dirName](qdir.html#dirName)（）和[absoluteFilePath](qdir.html#absoluteFilePath)（ ） 。 ``` bool QDir.cd (self, QString?dirName) ``` 更改[QDir](qdir.html)的目錄_dirName_。 返回True如果新的目錄存在并且可讀，否則返回False 。請注意，如果新的目錄不存在，不進行邏輯CD （）操作。 調用CD（ “..”）等同于調用[cdUp](qdir.html#cdUp)（ ） 。 **See also** [cdUp](qdir.html#cdUp)（ ）[isReadable](qdir.html#isReadable)（ ）[exists](qdir.html#exists)（）和[path](qdir.html#pathx)（ ） 。 ``` bool QDir.cdUp (self) ``` 通過移動一個目錄從該目錄的變化[QDir](qdir.html)目前的目錄。 返回True如果新的目錄存在并且可讀，否則返回False 。請注意，如果新的目錄不存在，不進行邏輯CDUP （）操作。 **See also** [cd](qdir.html#cd)（ ）[isReadable](qdir.html#isReadable)（ ）[exists](qdir.html#exists)（）和[path](qdir.html#pathx)（ ） 。 ``` QString QDir.cleanPath (QString?path) ``` 移除所有多個目錄分隔符“ / ” ，并解決在路徑中找到任何“ ，” s或“..” S，_path_。 符號鏈接將被保留。這個函數不返回規范路徑，而是將輸入的簡單版本。例如， “ /本地”變成了“本地” ， “本地/ 。 。 / bin”就會變成“垃圾桶”和“ /本地/ usr / 。 。 / bin”就會變成“ / local / bin目錄” 。 **See also** [absolutePath](qdir.html#absolutePath)（）和[canonicalPath](qdir.html#canonicalPath)（ ） 。 ``` QString QDir.convertSeparators (QString?pathName) ``` ``` int QDir.count (self) ``` 返回目錄和文件的目錄總數。 相當于[entryList](qdir.html#entryList)（ ） ， COUNT（ ） 。 **See also** [operator[]](qdir.html#operator-5b-5d)（）和[entryList](qdir.html#entryList)（ ） 。 ``` QDir QDir.current () ``` [ 返回應用程序的當前目錄。 ](qdir.html) [該目錄是使用當前目錄的絕對路徑，確保構建其](qdir.html)[path](qdir.html#pathx)（）將是相同的其[absolutePath](qdir.html#absolutePath)（ ） 。 **See also** [currentPath](qdir.html#currentPath)（ ）[setCurrent](qdir.html#setCurrent)（ ）[home](qdir.html#home)（ ）[root](qdir.html#root)（）和[temp](qdir.html#temp)（ ） 。 ``` QString QDir.currentPath () ``` 返回應用程序的當前目錄的絕對路徑。 **See also** [current](qdir.html#current)（ ）[setCurrent](qdir.html#setCurrent)（ ）[homePath](qdir.html#homePath)（ ）[rootPath](qdir.html#rootPath)（）和[tempPath](qdir.html#tempPath)（ ） 。 ``` QString QDir.dirName (self) ``` 返回目錄的名稱，這是_not_相同的路徑，例如名稱為“郵件”的目錄，可能有路徑“的/ var / spool / mail中” 。如果目錄沒有名稱（例如，它是根目錄）一個空字符串返回。 沒有檢查，以確保與此名稱的目錄確實存在，但看[exists](qdir.html#exists)（ ） 。 **See also** [path](qdir.html#pathx)（ ）[filePath](qdir.html#filePath)（ ）[absolutePath](qdir.html#absolutePath)（）和[absoluteFilePath](qdir.html#absoluteFilePath)（ ） 。 ``` list-of-QFileInfo QDir.drives () ``` 返回此系統的根目錄的列表。 在Windows中，此方法返回列表[QFileInfo](qfileinfo.html)包含對象的“C :/ ” ， “D ??:/ ”等在其他操作系統上，它返回一個包含只有一個根目錄（即“/”）的列表。 **See also** [root](qdir.html#root)（）和[rootPath](qdir.html#rootPath)（ ） 。 ``` list-of-QFileInfo QDir.entryInfoList (self, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort) ``` 返回列表[QFileInfo](qfileinfo.html)在目錄中的所有文件和目錄對象，根據名稱和屬性序濾事先用[setNameFilters](qdir.html#setNameFilters)（）和[setFilter](qdir.html#setFilter)（ ） ，并排序按設定的標志[setSorting](qdir.html#setSorting)（ ） 。 該名過濾器，文件屬性過濾和排序規范可以使用被復蓋的_nameFilters_，_filters_和_sort_參數。 返回空列表，如果該目錄是不可讀的，不存在，或者如果沒有的規格相匹配。 **See also** [entryList](qdir.html#entryList)（ ）[setNameFilters](qdir.html#setNameFilters)（ ）[setSorting](qdir.html#setSorting)（ ）[setFilter](qdir.html#setFilter)（ ）[isReadable](qdir.html#isReadable)（）和[exists](qdir.html#exists)（ ） 。 ``` list-of-QFileInfo QDir.entryInfoList (self, QStringList?nameFilters, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort) ``` 這是一個重載函數。 返回列表[QFileInfo](qfileinfo.html)在目錄中的所有文件和目錄對象，根據名稱和屬性序濾事先用[setNameFilters](qdir.html#setNameFilters)（）和[setFilter](qdir.html#setFilter)（ ） ，并排序按設定的標志[setSorting](qdir.html#setSorting)（ ） 。 該屬性過濾和排序的規定可以使用被復蓋的_filters_和_sort_參數。 返回空列表，如果該目錄是不可讀的，不存在，或者如果沒有的規格相匹配。 **See also** [entryList](qdir.html#entryList)（ ）[setNameFilters](qdir.html#setNameFilters)（ ）[setSorting](qdir.html#setSorting)（ ）[setFilter](qdir.html#setFilter)（ ）[isReadable](qdir.html#isReadable)（）和[exists](qdir.html#exists)（ ） 。 ``` QStringList QDir.entryList (self, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort) ``` 返回目錄中的所有文件和目錄的名稱列表，責令按照名稱和屬性之前設置過濾器[setNameFilters](qdir.html#setNameFilters)（）和[setFilter](qdir.html#setFilter)（ ） ，并排序按設定的標志[setSorting](qdir.html#setSorting)（ ） 。 該名過濾器，文件屬性過濾和排序規范可以使用被復蓋的_nameFilters_，_filters_和_sort_參數。 返回空列表，如果該目錄是不可讀的，不存在，或者如果沒有的規格相匹配。 **See also** [entryInfoList](qdir.html#entryInfoList)（ ）[setNameFilters](qdir.html#setNameFilters)（ ）[setSorting](qdir.html#setSorting)（）和[setFilter](qdir.html#setFilter)（ ） 。 ``` QStringList QDir.entryList (self, QStringList?nameFilters, Filters?filters?=?QDir.NoFilter, SortFlags?sort?=?QDir.NoSort) ``` 這是一個重載函數。 返回目錄中的所有文件和目錄的名稱列表，責令按照名稱和屬性之前設置過濾器[setNameFilters](qdir.html#setNameFilters)（）和[setFilter](qdir.html#setFilter)（ ） ，并排序按設定的標志[setSorting](qdir.html#setSorting)（ ） 。 該屬性過濾和排序的規定可以使用被復蓋的_filters_和_sort_參數。 返回空列表，如果該目錄是不可讀的，不存在，或者如果沒有的規格相匹配。 **Note:**要列出指向不存在的文件的符號鏈接，[System](qdir.html#Filter-enum)必須被傳遞到過濾器。 **See also** [entryInfoList](qdir.html#entryInfoList)（ ）[setNameFilters](qdir.html#setNameFilters)（ ）[setSorting](qdir.html#setSorting)（）和[setFilter](qdir.html#setFilter)（ ） 。 ``` bool QDir.exists (self) ``` 返回True如果調用的文件_name_存在，否則返回False 。 除非_name_包含一個絕對文件路徑，文件名被假定為是相對于目錄本身，所以這個功能通常用于檢查文件的目錄中存在。 **See also** [QFileInfo.exists](qfileinfo.html#exists)（）和[QFile.exists](qfile.html#exists)（ ） 。 ``` bool QDir.exists (self, QString?name) ``` 這是一個重載函數。 返回True如果該目錄存在，否則返回False 。 （如果找到具有相同名稱的文件此函數將返回False ） 。 這個函數接受一個參數的重載是用來測試文件和目錄的目錄中存在。 **See also** [QFileInfo.exists](qfileinfo.html#exists)（）和[QFile.exists](qfile.html#exists)（ ） 。 ``` QString QDir.filePath (self, QString?fileName) ``` 返回目錄中的文件的路徑名。是否_not_檢查文件是否確實存在于目錄，但看[exists](qdir.html#exists)（ ） 。如果[QDir](qdir.html)相對于返回的路徑名稱也將是相對的。冗馀的多個隔板或“。 ”中和“..”的目錄_fileName_不會被刪除（見[cleanPath](qdir.html#cleanPath)（））。 **See also** [dirName](qdir.html#dirName)（ ）[absoluteFilePath](qdir.html#absoluteFilePath)（ ）[isRelative](qdir.html#isRelative)（）和[canonicalPath](qdir.html#canonicalPath)（ ） 。 ``` Filters QDir.filter (self) ``` [](index.htm) [返回由設置的值](index.htm)[setFilter](qdir.html#setFilter)（ ） **See also** [setFilter](qdir.html#setFilter)（ ） 。 ``` QString QDir.fromNativeSeparators (QString?pathName) ``` Returns _pathName_用'/'作為文件分隔符。在Windows上，例如， fromNativeSeparators （ “`c:\\winnt\\system32`“）返回” C :/在winnt/system32 “ 。 返回的字符串可能是相同的說法在某些操作系統上，例如在Unix上。 這個函數中引入了Qt 4.2中。 **See also** [toNativeSeparators](qdir.html#toNativeSeparators)（）和[separator](qdir.html#separator)（ ） 。 ``` QDir QDir.home () ``` [ 返回用戶的主目錄。 ](qdir.html) [該目錄是使用主目錄的絕對路徑，確保構建其](qdir.html)[path](qdir.html#pathx)（）將是相同的其[absolutePath](qdir.html#absolutePath)（ ） 。 See [homePath](qdir.html#homePath)（ ）了解詳情。 **See also** [drives](qdir.html#drives)（ ）[current](qdir.html#current)（ ）[root](qdir.html#root)（）和[temp](qdir.html#temp)（ ） 。 ``` QString QDir.homePath () ``` 返回用戶的主目錄的絕對路徑。 在Windows下這個函數會返回當前用戶的配置文件的目錄。典型地，這是： ``` C:/Documents and Settings/Username ``` 使用[toNativeSeparators](qdir.html#toNativeSeparators)（ ）函數的分隔符轉換為那些適用于底層的操作系統。 如果當前用戶的配置文件的目錄不存在或無法檢索，下面的替代品將被選中（在給定的順序），直到現有的和可用的路徑中找到： 1. 由指定的路徑`USERPROFILE`環境變量。 2. 通過連接形成的路徑`HOMEDRIVE`和`HOMEPATH`環境變量。 3. 由指定的路徑`HOME`環境變量。 4. 在返回的路徑[rootPath](qdir.html#rootPath)（）函數（它使用`SystemDrive`環境變量） 5. 該`C:/`目錄。 在非Windows操作系統`HOME`環境變量用于如果存在的話，否則路徑的返回[rootPath](qdir.html#rootPath)（ ） 。 在Symbian這通常會返回“C :/數據”，即同本地PathInfo.PhoneMemoryRootPath （ ） 。 **See also** [home](qdir.html#home)（ ）[currentPath](qdir.html#currentPath)（ ）[rootPath](qdir.html#rootPath)（）和[tempPath](qdir.html#tempPath)（ ） 。 ``` bool QDir.isAbsolute (self) ``` 返回True如果該目錄的路徑是絕對的，否則返回False 。看[isAbsolutePath](qdir.html#isAbsolutePath)（ ） 。 **See also** [isRelative](qdir.html#isRelative)（ ）[makeAbsolute](qdir.html#makeAbsolute)（）和[cleanPath](qdir.html#cleanPath)（ ） 。 ``` bool QDir.isAbsolutePath (QString?path) ``` 返回True如果_path_是絕對的，如果它是相對于返回False 。 **See also** [isAbsolute](qdir.html#isAbsolute)（ ）[isRelativePath](qdir.html#isRelativePath)（ ）[makeAbsolute](qdir.html#makeAbsolute)（）和[cleanPath](qdir.html#cleanPath)（ ） 。 ``` bool QDir.isReadable (self) ``` 返回True如果該目錄是可讀的_and_我們可以通過名字打開文件，否則返回False 。 **Warning:**從這個函數值為False并不保證該目錄中的文件無法訪問。 **See also** [QFileInfo.isReadable](qfileinfo.html#isReadable)（ ） 。 ``` bool QDir.isRelative (self) ``` 返回True如果該目錄是相對路徑，否則返回False 。 （在Unix下的路徑是相對的，如果它不是以一個“/”） 。 **See also** [makeAbsolute](qdir.html#makeAbsolute)（ ）[isAbsolute](qdir.html#isAbsolute)（ ）[isAbsolutePath](qdir.html#isAbsolutePath)（）和[cleanPath](qdir.html#cleanPath)（ ） 。 ``` bool QDir.isRelativePath (QString?path) ``` 返回True如果_path_是相對的，如果它是絕對的返回False 。 **See also** [isRelative](qdir.html#isRelative)（ ）[isAbsolutePath](qdir.html#isAbsolutePath)（）和[makeAbsolute](qdir.html#makeAbsolute)（ ） 。 ``` bool QDir.isRoot (self) ``` 返回True如果該目錄是根目錄，否則返回False 。 注：如果該目錄是根目錄下的符號鏈接這個函數返回False 。如果你想測試這個使用[canonicalPath](qdir.html#canonicalPath)（ ），例如 ``` [QDir](qdir.html) dir("/tmp/root_link"); dir = dir.canonicalPath(); if (dir.isRoot()) qWarning("It is a root link"); ``` **See also** [root](qdir.html#root)（）和[rootPath](qdir.html#rootPath)（ ） 。 ``` bool QDir.makeAbsolute (self) ``` 目錄路徑為絕對路徑轉換。如果它已經絕對沒有任何反應。返回True如果轉換成功，否則返回False 。 **See also** [isAbsolute](qdir.html#isAbsolute)（ ）[isAbsolutePath](qdir.html#isAbsolutePath)（ ）[isRelative](qdir.html#isRelative)（）和[cleanPath](qdir.html#cleanPath)（ ） 。 ``` bool QDir.match (QStringList?filters, QString?fileName) ``` 返回True如果_fileName_匹配通配符（ GLOB ）模式_filter_否則返回False 。該_filter_可能包含由空格或分號分隔的多個模式。匹配不區分大小寫。 **See also** [QRegExp wildcard matching](qregexp.html#qregexp-wildcard-matching)，[QRegExp.exactMatch](qregexp.html#exactMatch)（ ）[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。 ``` bool QDir.match (QString?filter, QString?fileName) ``` 這是一個重載函數。 返回True如果_fileName_匹配任何通配符的（水珠）模式中的列表_filters_否則返回False 。匹配不區分大小寫。 **See also** [QRegExp wildcard matching](qregexp.html#qregexp-wildcard-matching)，[QRegExp.exactMatch](qregexp.html#exactMatch)（ ）[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。 ``` bool QDir.mkdir (self, QString?dirName) ``` 創建一個子目錄名為_dirName_。 成功時返回TRUE ，否則返回False 。 如果該目錄已經存在時，這個函數被調用時，它會返回False 。 **See also** [rmdir](qdir.html#rmdir)（ ） 。 ``` bool QDir.mkpath (self, QString?dirPath) ``` 創建該目錄路徑_dirPath_。 該函數將創建需要創建該目錄下所有的父目錄。 成功返回True ，否則返回False 。 如果路徑已經存在時，這個函數被調用時，它會返回True 。 **See also** [rmpath](qdir.html#rmpath)（ ） 。 ``` QStringList QDir.nameFilters (self) ``` 返回字符串列表進行設置[setNameFilters](qdir.html#setNameFilters)（ ） **See also** [setNameFilters](qdir.html#setNameFilters)（ ） 。 ``` QStringList QDir.nameFiltersFromString (QString?nameFilter) ``` ``` QString QDir.path (self) ``` ``` QDir.refresh (self) ``` 刷新的目錄信息。 ``` QString QDir.relativeFilePath (self, QString?fileName) ``` 返回的路徑_fileName_相對于該目錄。 ``` [QDir](qdir.html) dir("/home/bob"); [QString](qstring.html) s; s = dir.relativeFilePath("../img/file.jpg"); // s is "../img/file.jpg" s = dir.relativeFilePath("/home/mary/file.txt"); // s is "../mary/file.txt" ``` **See also** [absoluteFilePath](qdir.html#absoluteFilePath)（ ）[filePath](qdir.html#filePath)（）和[canonicalPath](qdir.html#canonicalPath)（ ） 。 ``` bool QDir.remove (self, QString?fileName) ``` 刪除該文件，_fileName_。 返回True如果文件被成功刪除，否則返回False 。 ``` bool QDir.rename (self, QString?oldName, QString?newName) ``` 重命名一個文件或目錄_oldName_至_newName_，并成功返回True ，否則返回False 。 在大多數的文件系統，重新命名（）失敗僅當_oldName_不存在，如果_newName_和_oldName_不在同一個分區，或者使用新名稱的文件已經存在。然而，也有其他原因，重命名（ ）可能會失敗。例如，在至少一個文件系統命名（）將失敗，如果_newName_指向一個打開的文件。 ``` bool QDir.rmdir (self, QString?dirName) ``` 通過移除指定的目錄_dirName_。 該目錄必須是空的命令rmdir （）來取得成功。 成功返回True ，否則返回False 。 **See also** [mkdir](qdir.html#mkdir)（ ） 。 ``` bool QDir.rmpath (self, QString?dirPath) ``` 刪除的目錄路徑_dirPath_。 該功能將刪除所有父目錄中_dirPath_，只要它們是空的。這是mkpath （ dirPath ）的對面。 成功返回True ，否則返回False 。 **See also** [mkpath](qdir.html#mkpath)（ ） 。 ``` QDir QDir.root () ``` [ 返回根目錄。 ](qdir.html) [該目錄是使用根目錄的絕對路徑，確保構造，其](qdir.html)[path](qdir.html#pathx)（）將是相同的其[absolutePath](qdir.html#absolutePath)（ ） 。 See [rootPath](qdir.html#rootPath)（ ）了解詳情。 **See also** [drives](qdir.html#drives)（ ）[current](qdir.html#current)（ ）[home](qdir.html#home)（）和[temp](qdir.html#temp)(). ``` QString QDir.rootPath () ``` 返回根目錄的絕對路徑。 對于Unix操作系統這將返回“ / ” 。對于Windows和Symbian的文件系統中，這通常會返回“C :/ ” 。 I.E.在系統驅動器的根目錄。 **See also** [root](qdir.html#root)（ ）[drives](qdir.html#drives)（ ）[currentPath](qdir.html#currentPath)（ ）[homePath](qdir.html#homePath)（）和[tempPath](qdir.html#tempPath)（ ） 。 ``` QStringList QDir.searchPaths (QString?prefix) ``` 返回的搜索路徑_prefix_。 此功能被引入Qt的4.3 。 **See also** [setSearchPaths](qdir.html#setSearchPaths)（）和[addSearchPath](qdir.html#addSearchPath)（ ） 。 ``` QChar QDir.separator () ``` 返回本機目錄分隔符“ / ”的Unix （包括Mac OS X ）根據與“\” Windows下。 你不需要使用這個功能來構建文件路徑。如果你總是使用“ / ” ， Qt將會把你的路徑，以符合底層操作系統。如果你想使用自己的操作系統的分隔符使用，以顯示給用戶的路徑[toNativeSeparators](qdir.html#toNativeSeparators)（ ） 。 ``` bool QDir.setCurrent (QString?path) ``` 設置應用程序的當前工作目錄_path_。返回True如果該目錄已成功更改，否則返回False 。 **See also** [current](qdir.html#current)（ ）[currentPath](qdir.html#currentPath)（ ）[home](qdir.html#home)（ ）[root](qdir.html#root)（）和[temp](qdir.html#temp)（ ） 。 ``` QDir.setFilter (self, Filters?filter) ``` 設置所使用的過濾器[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（）來_filters_。該過濾器是用于指定類型的文件，應當由被返回[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。看[QDir.Filter](qdir.html#Filter-enum)。 **See also** [filter](qdir.html#filter)（）和[setNameFilters](qdir.html#setNameFilters)（ ） 。 ``` QDir.setNameFilters (self, QStringList?nameFilters) ``` 設置所使用的過濾器名稱[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ）到由指定的過濾器列表_nameFilters_。 每名過濾器是一個通配符（通配符）過濾器能夠理解`*`和`?`通配符。 （見[QRegExp wildcard matching](qregexp.html#qregexp-wildcard-matching)。 ） 例如，下面的代碼設置在三名過濾器[QDir](qdir.html)以確保與擴展通常用于C + +源文件只有文件被列出： ``` [QStringList](qstringlist.html) filters; filters << "*.cpp" << "*.cxx" << "*.cc"; dir.setNameFilters(filters); ``` **See also** [nameFilters](qdir.html#nameFilters)（）和[setFilter](qdir.html#setFilter)（ ） 。 ``` QDir.setPath (self, QString?path) ``` 載到目錄的路徑_path_。的路徑被清除多馀的“...”， “...”和多個隔板。沒有檢查，看看這個路徑中的目錄是否真的存在，但你可以檢查自己使用[exists](qdir.html#exists)（ ） 。 該路徑可以是絕對的或相對的。絕對路徑開頭的目錄分隔符“ / ” （前面可以在Windows下的驅動器規格） 。相對文件名開頭的目錄名或文件名和路徑指定一個相對于當前目錄。絕對路徑的一個例子是字符串“ / tmp目錄/石英” ，相對路徑可能看起來像“的src / fatlib ” 。 **See also** [path](qdir.html#pathx)（ ）[absolutePath](qdir.html#absolutePath)（ ）[exists](qdir.html#exists)（ ）[cleanPath](qdir.html#cleanPath)（ ）[dirName](qdir.html#dirName)（ ）[absoluteFilePath](qdir.html#absoluteFilePath)（ ）[isRelative](qdir.html#isRelative)（）和[makeAbsolute](qdir.html#makeAbsolute)（ ） 。 ``` QDir.setSearchPaths (QString?prefix, QStringList?searchPaths) ``` 設置或替換文件名Qt的搜索路徑的前綴_prefix_至_searchPaths_。 要指定一個前綴的文件名，前面加上前綴后跟一個冒號（例如， “圖片： undo.png ” ， “ xmldocs ： books.xml”文件） 。_prefix_只能包含字母或數字（例如，它不能包含一個冒號，也沒有斜線） 。 Qt使用這個搜索路徑來定位文件與已知的前綴。搜索路徑條目，以便進行測試，從第一個項目。 ``` [QDir](qdir.html).setSearchPaths("icons", [QStringList](qstringlist.html)([QDir](qdir.html).homePath() + "/images")); [QDir](qdir.html).setSearchPaths("docs", [QStringList](qstringlist.html)(":/embeddedDocuments")); ... [QPixmap](qpixmap.html) pixmap("icons:undo.png"); // will look for undo.png in QDir.homePath() + "/images" [QFile](qfile.html) file("docs:design.odf"); // will look in the :/embeddedDocuments resource path ``` 文件名前綴必須至少為2個字符，以避免與Windows驅動器盤符沖突。 搜索路徑可能包含為路徑[The Qt Resource System](index.htm)。 此功能被引入Qt的4.3 。 **See also** [searchPaths](qdir.html#searchPaths)（ ） 。 ``` QDir.setSorting (self, SortFlags?sort) ``` 設置使用的排序順序[entryList](qdir.html#entryList)（）和[entryInfoList](qdir.html#entryInfoList)（ ） 。 該_sort_從枚舉指定的OR-ing值[QDir.SortFlag](qdir.html#SortFlag-enum)。 **See also** [sorting](qdir.html#sorting)（）和[SortFlag](qdir.html#SortFlag-enum)。 ``` SortFlags QDir.sorting (self) ``` [](index.htm) [返回由設置的值](index.htm)[setSorting](qdir.html#setSorting)（ ） **See also** [setSorting](qdir.html#setSorting)（）和[SortFlag](qdir.html#SortFlag-enum)。 ``` QDir QDir.temp () ``` [ 返回系統的臨時目錄。 ](qdir.html) [該目錄是使用臨時目錄的絕對路徑，確保構建其](qdir.html)[path](qdir.html#pathx)（）將是相同的其[absolutePath](qdir.html#absolutePath)（ ） 。 See [tempPath](qdir.html#tempPath)（ ）了解詳情。 **See also** [drives](qdir.html#drives)（ ）[current](qdir.html#current)（ ）[home](qdir.html#home)（）和[root](qdir.html#root)（ ） 。 ``` QString QDir.tempPath () ``` 返回系統的臨時目錄的絕對路徑。 在Unix / Linux系統中，這是在路徑`TMPDIR`環境變量或`/tmp`如果`TMPDIR`沒有定義。在Windows上，這是通常在路徑`TEMP` or `TMP`環境變量。目錄分隔符是否被添加到末尾與否，取決于操作系統。 **See also** [temp](qdir.html#temp)（ ）[currentPath](qdir.html#currentPath)（ ）[homePath](qdir.html#homePath)（）和[rootPath](qdir.html#rootPath)（ ） 。 ``` QString QDir.toNativeSeparators (QString?pathName) ``` Returns _pathName_用'/'分隔符轉換為分隔符是適用于底層的操作系統。 在Windows上， toNativeSeparators （ “C :/在winnt/system32 ”）返回“C ： \ WINNT \ SYSTEM32 ” 。 返回的字符串可能是相同的說法在某些操作系統上，例如在Unix上。 這個函數中引入了Qt 4.2中。 **See also** [fromNativeSeparators](qdir.html#fromNativeSeparators)（）和[separator](qdir.html#separator)（ ） 。 ``` int QDir.__contains__ (self, QString) ``` ``` bool QDir.__eq__ (self, QDir?dir) ``` ``` QString QDir.__getitem__ (self, int) ``` ``` QStringList QDir.__getitem__ (self, slice) ``` ``` QDir.__len__ (self) ``` ``` bool QDir.__ne__ (self, QDir?dir) ```