Qt：QDir

0、说明

QDir提供了访问目录及目录下内容的类。

QDir既可以用于访问文件系统，也可以用于访问Qt 资源系统（Qt's resource system.）。

Qt用 "/" 作为目录分隔符，此外，"/" 也是URL的路径分隔符。

QDir可以指向一个用相对路径或绝对路径指明的文件。绝对路径在不同系统下不同，Linux系统下，以文件分隔符"/"开始，如："/home/user/Documents"；在Windows系统下，以某个磁盘开始，如："C:/Documents and Settings"。相对路径直接以目录名、文件名开头，指明一个相对于当前目录的路径，如："images/landscape.png"。

我们可以用isRelative()和isAbsolute()来检查一个QDir是绝对还是相对的。调用makeAbsolute()可以将一个相对路径的QDir转换为绝对路径的QDir。

规范化路径：不含".."、"."、逻辑链接的路径（把这些简写的路径写全），绝对路径与相对路径中都可以含有这些路径。

逻辑链接：Linux系统中路径中的local代表根目录，如果根目录为usr，规范化路径中的local就会变成usr。

1）导航与目录操作

①路径

目录路径可以通过path()获取，通过setPath()设置新路径，通过absolutePath()获取到某个目录的绝对路径。

目录名通过dirName()获取，不过如果QDir表示的是当前目录，那会返回一个 "."：

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

目录路径也可以通过cd()、cdUp()进行修改，就像在命令行窗口中执行的那些shell命令。调用cd()时，如果传入了某个存在的目录路径，那么这个QDir就实际代表了这个目录。而cdUp()则会改变该QDir到父目录。这样的话，cd( ".." )就相当于cdUp()。

②添加、删除、修改

目录通过mkdir()创造，通过rename()重命名，通过rmdir()移除。

③检查

通过exists()检查某个目录是否存在；目录的属性可以通过 isReadable(), isAbsolute(), isRelative(), 和 isRoot() 进行检查。

④重读某目录：refresh()

2）文件与目录的内容

①路径上的要素

目录路径上有一系列的要素：文件、目录、符号链接。要素的数量通过count()得到，它们的名字通过entryList()保存在一个QStringList中，如果我们需要每个要素的信息，可以通过entryInfoList()来获取一个QList<QFileInfo>。

②构造路径、移除

通过filePath()、absoluteFilePath()构造一个从QDir指定的目录到某个文件、目录的绝对路径与相对路径。不过它们都不会检查该路径是否存在，它们仅仅用于构造路径：

QDir directory("Documents/Letters");
QString path = directory.filePath("contents.txt");
QString absolutePath = directory.absoluteFilePath("contents.txt");

通过remove()移除文件，通过rmdir()移除目录。

③filter

在用entryList()与entryInfoList()获取要素时，可以引入过滤器来筛选符合要求的要素：例如筛选包含某子串的文件、分离文件与目录等：

名字filter通过QStringList传入setNameFilters()进行构建；

属性filter通过多个用OR连接的Filter进行构建，方法是setFilter()；

排序顺序由setSorting()传入的一系列用OR（即 | ）连接的SortFlags构建。

可以通过match()来检查某个文件名是否符合filter。

3）当前目录与其他路径

有两类static方法用于获取路径，一类返回QDir，一类返回QString：

QDir	QString	Return Value
current()	currentPath()	The application's working directory
home()	homePath()	The user's home directory
root()	rootPath()	The root directory
temp()	tempPath()	The system's temporary directory

可以用setCurrent()来设置程序的工作目录。如果我们想知道应用的可执行文件所在的目录，可以用QCoreApplication::applicationDirPath()。

drives()方法给出了该文件系统的所有根目录构成的List。在Unix系统中，返回一个包含单个"/"的List，它就是系统根目录。在Windows系统下，它会返回包含系统所有盘的QList<QFileInfo>。

4）路径操作与字符串

Path中如果包含元素 "."，说明是当前目录；包含".."，说明是parent目录；包含逻辑链接说明是规范目录，规范目录通过canonicalPath()构建。

通过cleanPath()可以简化path，移除path中多余的"/"与".."。

有时我们需要构造一些自制分隔符的路径，可以用toNativeSeparators()。

5）例子

①检查目录是否存在：exists()

QDir dir("example");
if (!dir.exists())
    qWarning("Cannot find the example directory");

也可以用QFile::exists()

②遍历目录、读取文件

QDir dir = QDir::root();                 // "/"
if (!dir.cd("tmp")) {                    // "/tmp"
    qWarning("Cannot find the \"/tmp\" directory");
} else {
    QFile file(dir.filePath("ex1.txt")); // "/tmp/ex1.txt"
    if (!file.open(QIODevice::ReadWrite))
        qWarning("Cannot create the file %s", file.name());
}

列出当前目录下的所有文件，按文件size从小到大排列：

#include <QDir>
#include <iostream>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    QDir dir;
    dir.setFilter(QDir::Files | QDir::Hidden | QDir::NoSymLinks);
    dir.setSorting(QDir::Size | QDir::Reversed);

    QFileInfoList list = dir.entryInfoList();
    std::cout << "     Bytes Filename" << std::endl;
    for (int i = 0; i < list.size(); ++i) {
        QFileInfo fileInfo = list.at(i);
        std::cout << qPrintable(QString("%1 %2").arg(fileInfo.size(), 10)
                                                .arg(fileInfo.fileName()));
        std::cout << std::endl;
    }
    return 0;
}

1、模块和加载项

Header:	#include <QDir>
qmake:	QT += core

2、构造

QDir(QString path, QString nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)	用path构造QDir，nameFilter指定过滤的元素
QDir(QString path = QString())	构造QDir指向path，如果path为空，则程序工作目录"."会被使用
QDir(QDir dir)	另一个QDir的副本

3、静态字段

enum	Filter { Dirs, AllDirs, Files, Drives, NoSymLinks, …, CaseSensitive }	用于entryList() 和entryInfoList()中，描述了筛选选项。
flags	Filters
enum	SortFlag { Name, Time, Size, Type, Unsorted, …, LocaleAware }	用于entryList() 和entryInfoList()中的排序，按照 名字、大小、时间 等等排序
flags	SortFlags

5、静态方法

返回值类型	方法	说明
void	addSearchPath(QString prefix, QString path)	为path加前缀prefix
QString	cleanPath(QString path)	移除path中冗余的分隔符，"."和".."
QDir	current()	当前目录对应的QDir
QString	currentPath()	当前目录的绝对路径
QFileInfoList	drives()	系统根目录的list
QString	fromNativeSeparators(QString pathName)	用指定分隔符进行路径分割，默认用"/"
QDir	home()	home目录
QString	homePath()	home目录的路径
bool	isAbsolutePath(QString path)	是否为绝对路径
bool	isRelativePath(QString path)	是否为相对路径
QChar	listSeparator()	path分隔符： Unix下是":" Windows下是";"
bool	match(QString filter, QString fileName) match(QStringList filters, QString fileName)	检查fileName是否符合filter的规则
QDir	root()	根目录QDir
QString	rootPath()	根目录路径
QStringList	searchPaths(QString prefix)	prefix的检索目录
QChar	separator()	目录分隔符：Unix中是"/"；Windows中是"\"
bool	setCurrent(QString path)	设置当前工作目录
void	setSearchPaths(QString prefix, QStringList searchPaths)	给搜索路径searchPaths加前缀prefix
QDir	temp()	返回系统的临时目录QDir
QString	tempPath()	临时目录路径
QString	toNativeSeparators(QString pathName)	将pathName中的"/"分隔符转换系统分隔符，返回转换后的路径

6、实例方法

返回值类型	方法	说明
QDir & bool bool QString	operator=(QDir dir) operator!=(QDir dir) operator==(QDir dir) operator[](int pos)	赋值 两个QDir的路径是否相同，并不是QDir是否相等。 dir[i]：提取路径中第i个元素。等同于entryList().at(i)
QString	absoluteFilePath(QString fileName)	返回指定文件的绝对路径，并不检查文件是否存在。冗余分隔符并不会被去除（通过cleanPath()去除）
	absolutePath()	返回QDir的绝对路径。
	canonicalPath()	返回规范化路径。
bool	cd(QString dirName)	改变QDir到dirName指定的目录。 与命令行窗口中的cd指令类似。
bool	cdUp()	改变QDir到上一级目录
uint	count()	计算路径上的元素数（目录数+文件数）
QString	dirName()	目录名
QFileInfoList QStringList	entryInfoList(QStringList nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) entryInfoList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) entryList(QStringList nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) entryList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort)	路径上的元素（目录+文件）及其信息
bool	exists(QString name) exists()	指定路径是否存在 当前QDir对应的路径是否存在
QString	filePath(QString fileName)	返回当前目录下的fileName的路径，不管是否存在，不检查冗余分隔符。
QDir::Filters	filter()	setFilter()设置的Filter值
bool	isAbsolute()	是否为绝对路径
	isEmpty(QDir::Filters filters = Filters(AllEntries | NoDotAndDotDot))	目录是否为空目录
	isReadable()	是否可读
	isRelative()	是否为相对路径
	isRoot()	是否为根目录
bool	makeAbsolute()	将QDir的路径转为绝对路径
	mkdir(QString dirName)	新建目录
	mkpath(QString dirPath)	新建路径上的所有目录
QStringList	nameFilters()	返回setNameFilters()设置的QStringList
QString	path()	返回路径，可能包含逻辑链接，但不包含冗余.和..和分隔符。 可以是绝对路径和相对路径
void	refresh()	文档刷新
QString	relativeFilePath(QString fileName)	返回fileName相较于QDir之间的路径
bool	remove(QString fileName)	移除文件
	removeRecursively()	移除QDir指定的目录，包括它的内容
	rename(QString oldName, QString newName)	重命名
	rmdir(QString dirName)	移除目录，该目录必须为空 要删除目录和目录下的内容用removeRecursively()
	rmpath(QString dirPath)	移除路径dirPath，并且会一级一级删除它的父目录（在父目录只包含一个目录的时候）
void	setFilter(QDir::Filters filters)	设置用于entryList() 和 entryInfoList()提取元素的Filter
	setNameFilters(QStringList nameFilters)	设置用于entryList() 和 entryInfoList()提取元素的Filter List
	setPath(QString path)	设置QDir路径为path，该路径是clean的，可以是绝对和相对路径。 不检查路径是否存在。
	setSorting(QDir::SortFlags sort)	设置用于entryList() 和 entryInfoList()提取元素的排序算法
QDir::SortFlags	sorting()	返回setSorting()的值
void	swap(QDir &other)	互换两个QDir的值