📄 qdir.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/tools/qdir.cpp:51 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=gb2312"><meta name="Translator" content="Cavendish"><meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt"><title>QDir类</title><style type="text/css"><!--h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }a:link { color: #004faf; text-decoration: none }a:visited { color: #672967; text-decoration: none }body { background: #ffffff; color: black; font-family: "Times New Roman" }--></style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr bgcolor="#E5E5E5"><td valign=center> <a href="index.html"><font color="#004faf">主页</font></a> | <a href="classes.html"><font color="#004faf">所有的类</font></a> | <a href="mainclasses.html"><font color="#004faf">主要的类</font></a> | <a href="annotated.html"><font color="#004faf">注释的类</font></a> | <a href="groups.html"><font color="#004faf">分组的类</font></a> | <a href="functions.html"><font color="#004faf">函数</font></a></td><td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QDir类参考</h1><p>QDir类提供了访问目录结构和它们的内容的与平台无关的方式。<a href="#details">详情请见……</a><p><tt>#include <<a href="qdir-h.html">qdir.h</a>></tt><p><a href="qdir-members.html">所有成员函数的列表。</a><h2>公有成员</h2><ul><li><div class=fn>enum <a href="#FilterSpec-enum"><b>FilterSpec</b></a> { Dirs = 0x001, Files = 0x002, Drives = 0x004, NoSymLinks = 0x008, All = 0x007, TypeMask = 0x00F, Readable = 0x010, Writable = 0x020, Executable = 0x040, RWEMask = 0x070, Modified = 0x080, Hidden = 0x100, System = 0x200, AccessMask = 0x3F0, DefaultFilter = -1 }</div></li><li><div class=fn>enum <a href="#SortSpec-enum"><b>SortSpec</b></a> { Name = 0x00, Time = 0x01, Size = 0x02, Unsorted = 0x03, SortByMask = 0x03, DirsFirst = 0x04, Reversed = 0x08, IgnoreCase = 0x10, DefaultSort = -1 }</div></li><li><div class=fn><a href="#QDir"><b>QDir</b></a> ()</div></li><li><div class=fn><a href="#QDir-2"><b>QDir</b></a> ( const QString & path, const QString & nameFilter = QString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All )</div></li><li><div class=fn><a href="#QDir-3"><b>QDir</b></a> ( const QDir & d )</div></li><li><div class=fn>virtual <a href="#~QDir"><b>~QDir</b></a> ()</div></li><li><div class=fn>QDir & <a href="#operator-eq"><b>operator=</b></a> ( const QDir & d )</div></li><li><div class=fn>QDir & <a href="#operator-eq-2"><b>operator=</b></a> ( const QString & path )</div></li><li><div class=fn>virtual void <a href="#setPath"><b>setPath</b></a> ( const QString & path )</div></li><li><div class=fn>virtual QString <a href="#path"><b>path</b></a> () const</div></li><li><div class=fn>virtual QString <a href="#absPath"><b>absPath</b></a> () const</div></li><li><div class=fn>virtual QString <a href="#canonicalPath"><b>canonicalPath</b></a> () const</div></li><li><div class=fn>virtual QString <a href="#dirName"><b>dirName</b></a> () const</div></li><li><div class=fn>virtual QString <a href="#filePath"><b>filePath</b></a> ( const QString & fileName, bool acceptAbsPath = TRUE ) const</div></li><li><div class=fn>virtual QString <a href="#absFilePath"><b>absFilePath</b></a> ( const QString & fileName, bool acceptAbsPath = TRUE ) const</div></li><li><div class=fn>virtual bool <a href="#cd"><b>cd</b></a> ( const QString & dirName, bool acceptAbsPath = TRUE )</div></li><li><div class=fn>virtual bool <a href="#cdUp"><b>cdUp</b></a> ()</div></li><li><div class=fn>QString <a href="#nameFilter"><b>nameFilter</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setNameFilter"><b>setNameFilter</b></a> ( const QString & nameFilter )</div></li><li><div class=fn>FilterSpec <a href="#filter"><b>filter</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setFilter"><b>setFilter</b></a> ( int filterSpec )</div></li><li><div class=fn>SortSpec <a href="#sorting"><b>sorting</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setSorting"><b>setSorting</b></a> ( int sortSpec )</div></li><li><div class=fn>bool <a href="#matchAllDirs"><b>matchAllDirs</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setMatchAllDirs"><b>setMatchAllDirs</b></a> ( bool enable )</div></li><li><div class=fn>uint <a href="#count"><b>count</b></a> () const</div></li><li><div class=fn>QString <a href="#operator[]"><b>operator[]</b></a> ( int index ) const</div></li><li><div class=fn>virtual QStrList encodedEntryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const <em>(obsolete)</em></div></li><li><div class=fn>virtual QStrList encodedEntryList ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const <em>(obsolete)</em></div></li><li><div class=fn>virtual QStringList <a href="#entryList-2"><b>entryList</b></a> ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const</div></li><li><div class=fn>virtual QStringList <a href="#entryList"><b>entryList</b></a> ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const</div></li><li><div class=fn>virtual const QFileInfoList * <a href="#entryInfoList-2"><b>entryInfoList</b></a> ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const</div></li><li><div class=fn>virtual const QFileInfoList * <a href="#entryInfoList"><b>entryInfoList</b></a> ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const</div></li><li><div class=fn>virtual bool <a href="#mkdir"><b>mkdir</b></a> ( const QString & dirName, bool acceptAbsPath = TRUE ) const</div></li><li><div class=fn>virtual bool <a href="#rmdir"><b>rmdir</b></a> ( const QString & dirName, bool acceptAbsPath = TRUE ) const</div></li><li><div class=fn>virtual bool <a href="#isReadable"><b>isReadable</b></a> () const</div></li><li><div class=fn>virtual bool <a href="#exists-2"><b>exists</b></a> () const</div></li><li><div class=fn>virtual bool <a href="#isRoot"><b>isRoot</b></a> () const</div></li><li><div class=fn>virtual bool <a href="#isRelative"><b>isRelative</b></a> () const</div></li><li><div class=fn>virtual void <a href="#convertToAbs"><b>convertToAbs</b></a> ()</div></li><li><div class=fn>virtual bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QDir & d ) const</div></li><li><div class=fn>virtual bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QDir & d ) const</div></li><li><div class=fn>virtual bool <a href="#remove"><b>remove</b></a> ( const QString & fileName, bool acceptAbsPath = TRUE )</div></li><li><div class=fn>virtual bool <a href="#rename"><b>rename</b></a> ( const QString & oldName, const QString & newName, bool acceptAbsPaths = TRUE )</div></li><li><div class=fn>virtual bool <a href="#exists"><b>exists</b></a> ( const QString & name, bool acceptAbsPath = TRUE )</div></li></ul><h2>静态公有成员s</h2><ul><li><div class=fn>QString <a href="#convertSeparators"><b>convertSeparators</b></a> ( const QString & pathName )</div></li><li><div class=fn>const QFileInfoList * <a href="#drives"><b>drives</b></a> ()</div></li><li><div class=fn>char <a href="#separator"><b>separator</b></a> ()</div></li><li><div class=fn>bool <a href="#setCurrent"><b>setCurrent</b></a> ( const QString & path )</div></li><li><div class=fn>QDir <a href="#current"><b>current</b></a> ()</div></li><li><div class=fn>QDir <a href="#home"><b>home</b></a> ()</div></li><li><div class=fn>QDir <a href="#root"><b>root</b></a> ()</div></li><li><div class=fn>QString <a href="#currentDirPath"><b>currentDirPath</b></a> ()</div></li><li><div class=fn>QString <a href="#homeDirPath"><b>homeDirPath</b></a> ()</div></li><li><div class=fn>QString <a href="#rootDirPath"><b>rootDirPath</b></a> ()</div></li><li><div class=fn>bool <a href="#match-2"><b>match</b></a> ( const QStringList & filters, const QString & fileName )</div></li><li><div class=fn>bool <a href="#match"><b>match</b></a> ( const QString & filter, const QString & fileName )</div></li><li><div class=fn>QString <a href="#cleanDirPath"><b>cleanDirPath</b></a> ( const QString & filePath )</div></li><li><div class=fn>bool <a href="#isRelativePath"><b>isRelativePath</b></a> ( const QString & path )</div></li></ul><hr><a name="details"></a><h2>详细描述</h2>QDir类提供了访问目录结构和它们的内容的与平台无关的方式。<p> <p> QDir用来操作路径名称、关于路径和文件的访问信息和操作底层文件系统。<p> QDir使用相对或绝对文件路径来指向一个文件。绝对路径是从目录分隔符“/”或者带有一个驱动器标识（除了在Unix下）。如果你总是使用“/”作为目录分隔符，Qt将会把你的路径转化为符合底层的操作系统的。相对文件名是由一个目录名称或者文件名开始并且指定一个相对于当前路径的路径。<p> “当前”路径是指应用程序的工作目录。QDir自己的路径可以通过<a href="#setPath">setPath</a>()设置并且通过<a href="#path">path</a>()获得。<p> 一个绝对路径的实例是字符串“/tmp/quartz”，相对路径看起来像是“src/fatlib”。你可以使用函数<a href="#isRelative">isRelative</a>()来检查一个QDir使用的是相对还是绝对文件路径。调用<a href="#convertToAbs">convertToAbs</a>()可以把一个相对的QDir转化为绝对的。使用<a href="#cleanDirPath">cleanDirPath</a>()可以得到一个简化的路径。为了获得没有符号连接或者多余的“..”元素的路径，请使用<a href="#canonicalPath">canonicalPath</a>()。路径可以通过setPath()设置，或者使用<a href="#cd">cd</a>()和<a href="#cdUp">cdUp</a>()来改变。<p> QDir提供了几个静态函数，例如，<a href="#setCurrent">setCurrent</a>()设置应用程序的工作目录并且<a href="#currentDirPath">currentDirPath</a>()来获得应用程序的工作目录。访问一些普通的路径是由以下一些静态函数提供的，<a href="#current">current</a>()、<a href="#home">home</a>()和<a href="#root">root</a>()返回QDir对象或者currentDirPath()、<a href="#homeDirPath">homeDirPath</a>()和<a href="#rootDirPath">rootDirPath</a>()返回字符串路径。<p> <a href="#count">count</a>()返回目录中的条目数量。通过<a href="#entryList">entryList</a>()可以获得目录中的所有文件和目录的名称的字符串列表。如果你希望得到<a href="qfileinfo.html">QFileInfo</a>指针的列表请使用<a href="#entryInfoList">entryInfoList</a>()。这些函数都可以使用名称过滤器、属性过滤器（例如只读、只要文件不要目录等等）和排列顺序。过滤器和排序可以调用<a href="#setNameFilter">setNameFilter</a>()、<a href="#setFilter">setFilter</a>()和<a href="#setSorting">setSorting</a>()来设置。它们可以通过entryList()和entryInfoList()的参数来指定。<p> <a href="#mkdir">mkdir</a>()可以创建一个新目录，<a href="#rename">rename</a>()可以重命名一个目录并且<a href="#rmdir">rmdir</a>()可以移除一个已经存在的目录。<a href="#remove">remove</a>()可以移除一个已经存在的文件。你可以通过<a href="#exists">exists</a>()、<a href="#isReadable">isReadable</a>()和<a href="#isRoot">isRoot</a>()来询问一个目录。<p> 使用<a href="#filePath">filePath</a>()可以得到一个带有文件名的路径，并且<a href="#dirName">dirName</a>()可以得到目录名称，这两个函数都不能检测文件或者目录是否存在。<p> <a href="#drives">drives</a>()提供根目录的列表，在Unix系统上，这个返回一个只包含根目录“/”的列表，在Windows上，这个列表将包含“C:/”并且还有“D:/”等等。<p> 如果你需要一个适应底层操作系统形式的路径，请使用<a href="#convertSeparators">convertSeparators</a>()。<p> 实例：<p> 请参考一个目录是否存在。<pre> QDir d( "example" ); // “./example” if ( !d.<a href="#exists">exists</a>() ) <a href="qapplication.html#qWarning">qWarning</a>( "Cannot find the example directory" ); </pre> <p> Traversing directories and reading a file.<pre> QDir d = QDir::<a href="#root">root</a>(); // “/” if ( !d.<a href="#cd">cd</a>("tmp") ) { // “/tmp” <a href="qapplication.html#qWarning">qWarning</a>( "Cannot find the \"/tmp\" directory" ); } else { <a href="qfile.html">QFile</a> f( d.<a href="#filePath">filePath</a>("ex1.txt") ); // “/tmp/ex1.txt” if ( !f.<a href="qfile.html#open">open</a>(IO_ReadWrite) ) <a href="qapplication.html#qWarning">qWarning</a>( "Cannot create the file %s", f.<a href="qfile.html#name">name</a>() ); } </pre> <p> 一个列出当前目录中所有文件（不包括符号连接）的程序，按大小排序，小的在前。<pre> #include <stdio.h> #include <<a href="qdir-h.html">qdir.h</a>> int main( int argc, char **argv ) { QDir d; d.<a href="#setFilter">setFilter</a>( QDir::<a href="#FilterSpec-enum">Files</a> | QDir::<a href="#FilterSpec-enum">Hidden</a> | QDir::<a href="#FilterSpec-enum">NoSymLinks</a> );⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -