qdir.html

QT的帮助

返回应用程序当前目录的绝对路径。
<p>也可以参考<a href="#current">current</a>()。
<p>实例：<a href="helpviewer-example.html#x987">helpviewer/helpwindow.cpp</a>和<a href="qdir-example.html#x1806">qdir/qdir.cpp</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="dirName"></a>QDir::dirName () const<tt> [虚]</tt>
</h3>
返回目录的名称，这和路径是<em>不同的</em>，例如一个名称为“mail”的目录，也许路径为“/var/spool/mail”。如果目录没有名字（例如，它是根目录），一个零字符串被返回。
<p> 不会执行检测来确保这个名称的目录真正存在。
<p> <p>也可以参考<a href="#path">path</a>()、<a href="#absPath">absPath</a>()、<a href="#absFilePath">absFilePath</a>()、<a href="#exists">exists</a>()和<a href="qstring.html#isNull">QString::isNull</a>()。

<h3 class=fn>const QFileInfoList * <a name="drives"></a>QDir::drives ()<tt> [静态]</tt>
</h3>
返回这个系统中根目录的列表。在Windows中，这将返回许多包含“”、“”等等的<a href="qfileinfo.html">QFileInfo</a>对象。在其它操作系统，它返回的是只包含一个根目录（例如“/”）的列表。
<p> 返回的指针的所有权归Qt。调用者<em>不要</em>删除或者修改它。
<p>实例：<a href="dirview-example.html#x1750">dirview/main.cpp</a>。

<h3 class=fn><a href="qstrlist.html">QStrList</a> <a name="encodedEntryList"></a>QDir::encodedEntryList ( int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这个函数被包含是因为可以很容易地从Qt 1.x移植到Qt 3.0，它和<a href="#entryList">entryList</a>()是一样地，但是文件名的编码方式是使用QFile::encodedName()的8位字符串。
<p> 使用它比使用entryList()更有效率。

<h3 class=fn><a href="qstrlist.html">QStrList</a> <a name="encodedEntryList-2"></a>QDir::encodedEntryList ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter, int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这是一个重载成员函数，用于提供方便。它的行为基于上面的函数。
<p> 这个函数被包含是因为可以很容易地从Qt 1.x移植到Qt 3.0，它和<a href="#entryList">entryList</a>()是一样地，但是文件名的编码方式是使用QFile::encodedName()的8位字符串。
<p> 使用它比使用entryList()更有效率。

<h3 class=fn>const QFileInfoList * <a name="entryInfoList"></a>QDir::entryInfoList ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter, int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
返回这个目录中所有目录和文件的<a href="qfileinfo.html">QFileInfo</a>对象的列表，根据<a href="#setSorting">setSorting</a>()排序并且根据<a href="#setFilter">setFilter</a>()和<a href="#setNameFilter">setNameFilter</a>()进行过滤。
<p> 过滤器和排序的规定可以使用<em>nameFilter</em>、<em>filterSpec</em>和<em>sortSpec</em>参数来指定。
<p> 如果这个目录是不可读的或者不存在，返回0。
<p> 返回的指针是一个指向QFileInfoList的常量指针。这个列表归QDir对象所有并且将会在同一个QDir实例下次调用<a href="#entryInfoList">entryInfoList</a>()时被重新使用。如果你想在调用这个函数之后保留这个列表的条目，你将需要复制它们。
<p> <p>也可以参考<a href="#entryList">entryList</a>()、<a href="#setNameFilter">setNameFilter</a>()、<a href="#setSorting">setSorting</a>()和<a href="#setFilter">setFilter</a>()。
<p>实例：<a href="dirview-example.html#x1706">dirview/dirview.cpp</a>和<a href="fileiconview-example.html#x808">fileiconview/qfileiconview.cpp</a>。

<h3 class=fn>const QFileInfoList * <a name="entryInfoList-2"></a>QDir::entryInfoList ( int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回这个目录中所有目录和文件的<a href="qfileinfo.html">QFileInfo</a>对象的列表，根据<a href="#setSorting">setSorting</a>()排序并且根据<a href="#setFilter">setFilter</a>()和<a href="#setNameFilter">setNameFilter</a>()进行过滤。
<p> 过滤器和排序的规定可以使用<em>filterSpec</em>和<em>sortSpec</em>参数来指定。
<p> 如果这个目录是不可读的或者不存在，返回0。
<p> 返回的指针是一个指向QFileInfoList的常量指针。这个列表归QDir对象所有并且将会在同一个QDir实例下次调用<a href="#entryInfoList">entryInfoList</a>()时被重新使用。如果你想在调用这个函数之后保留这个列表的条目，你将需要复制它们。
<p> <p>也可以参考<a href="#entryList">entryList</a>()、<a href="#setNameFilter">setNameFilter</a>()、<a href="#setSorting">setSorting</a>()和<a href="#setFilter">setFilter</a>()。

<h3 class=fn><a href="qstringlist.html">QStringList</a> <a name="entryList"></a>QDir::entryList ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter, int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
返回这个目录中所有目录和文件的名称的列表，根据<a href="#setSorting">setSorting</a>()排序并且根据<a href="#setFilter">setFilter</a>()和<a href="#setNameFilter">setNameFilter</a>()进行过滤。
<p> 过滤器和排序的规定可以使用<em>nameFilter</em>、<em>filterSpec</em>和<em>sortSpec</em>参数来指定。
<p> 如果这个目录是不可读的或者不存在，返回空的列表。。
<p> <p>也可以参考<a href="#entryInfoList">entryInfoList</a>()、<a href="#setNameFilter">setNameFilter</a>()、<a href="#setSorting">setSorting</a>()和<a href="#setFilter">setFilter</a>()。
<p>实例：<a href="statistics-example.html#x2627">table/statistics/statistics.cpp</a>。

<h3 class=fn><a href="qstringlist.html">QStringList</a> <a name="entryList-2"></a>QDir::entryList ( int&nbsp;filterSpec = DefaultFilter, int&nbsp;sortSpec = DefaultSort ) const<tt> [虚]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回这个目录中所有目录和文件的名称的列表，根据<a href="#setSorting">setSorting</a>()排序并且根据<a href="#setFilter">setFilter</a>()和<a href="#setNameFilter">setNameFilter</a>()进行过滤。
<p> 过滤器和排序的规定可以使用<em>filterSpec</em>和<em>sortSpec</em>参数来指定。
<p> 如果这个目录是不可读的或者不存在，返回空的列表。。
<p> <p>也可以参考<a href="#entryInfoList">entryInfoList</a>()、<a href="#setNameFilter">setNameFilter</a>()、<a href="#setSorting">setSorting</a>()和<a href="#setFilter">setFilter</a>()。

<h3 class=fn>bool <a name="exists"></a>QDir::exists ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;name, bool&nbsp;acceptAbsPath = TRUE )<tt> [虚]</tt>
</h3>
检查文件<em>name</em>的存在性。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的路径将会使用绝对路径检查这个文件。如果<em>acceptAbsPath</em>为假，<em>name</em>开始的任何数量的分隔符将会被移除并且结果文件名将被检查。
<p> 如果文件存在，返回真，否则返回假。
<p> <p>也可以参考<a href="qfileinfo.html#exists">QFileInfo::exists</a>()和<a href="qfile.html#exists">QFile::exists</a>()。

<h3 class=fn>bool <a name="exists-2"></a>QDir::exists () const<tt> [虚]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果<em>directory</em>存在，返回真。（如果发现一个同名的文件，这个函数将返回假）。
<p> <p>也可以参考<a href="qfileinfo.html#exists">QFileInfo::exists</a>()和<a href="qfile.html#exists">QFile::exists</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="filePath"></a>QDir::filePath ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;fileName, bool&nbsp;acceptAbsPath = TRUE ) const<tt> [虚]</tt>
</h3>
返回目录中一个文件的路径名称。<em>不</em>检查这个文件是否真的存在于这个目录中。如果QDir是相对的，返回的路径名称也是相对的。<em>fileName</em>中多余的多重分隔符或者“.”和“..”目录将被移除（请参考<a href="#cleanDirPath">cleanDirPath</a>()）。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的<em>fileName</em>将会被不改变地立即返回。如果<em>acceptAbsPath</em>为假，绝对路径将被被加到<em>fileName</em>的前面并且结果字符串被返回。
<p> <p>也可以参考<a href="#absFilePath">absFilePath</a>()、<a href="#isRelative">isRelative</a>()和<a href="#canonicalPath">canonicalPath</a>()。

<h3 class=fn><a href="qdir.html#FilterSpec-enum">FilterSpec</a> <a name="filter"></a>QDir::filter () const
</h3>
返回由<a href="#setFilter">setFilter</a>()设置的值。

<h3 class=fn><a href="qdir.html">QDir</a> <a name="home"></a>QDir::home ()<tt> [静态]</tt>
</h3>
返回主目录。
<p> 在Windows NT/2000下，这个函数通过连接<tt>HOMEDRIVE</tt>和<tt>HOMEPATH</tt>环境变量来形成这个路径。
<p> 在Windows 9x和非Windows操作系统，<tt>HOME</tt>环境变量被使用。
<p> 如果这个环境变量没有被设置，<a href="#rootDirPath">rootDirPath</a>()用来代替它。
<p> <p>也可以参考<a href="#homeDirPath">homeDirPath</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="homeDirPath"></a>QDir::homeDirPath ()<tt> [静态]</tt>
</h3>
<p> 返回用户的主目录的绝对路径。
<p>也可以参考<a href="#home">home</a>()。

<h3 class=fn>bool <a name="isReadable"></a>QDir::isReadable () const<tt> [虚]</tt>
</h3>
如果目录是可读的<em>并且</em>我们可以通过名称打开文件，返回真。如果只有上述一个条件存在，这个函数返回假。
<b>警告：</b> 这个函数返回的假并不保证这个目录不可访问。
<p> <p>也可以参考<a href="qfileinfo.html#isReadable">QFileInfo::isReadable</a>()。
<p>实例：<a href="dirview-example.html#x1707">dirview/dirview.cpp</a>和<a href="fileiconview-example.html#x809">fileiconview/qfileiconview.cpp</a>。

<h3 class=fn>bool <a name="isRelative"></a>QDir::isRelative () const<tt> [虚]</tt>
</h3>
如果目录路径是相对于当前路径的，返回真，并且如果路径是绝对的（例如在Unix下，一个路径如果没有以“/”开始就是相对的），返回假。
<p> <p>也可以参考<a href="#convertToAbs">convertToAbs</a>()。

<h3 class=fn>bool <a name="isRelativePath"></a>QDir::isRelativePath ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;path )<tt> [静态]</tt>
</h3>
如果<em>path</em>是相对的，返回真，如果它是绝对的，返回假。
<p>也可以参考<a href="#isRelative">isRelative</a>()。

<h3 class=fn>bool <a name="isRoot"></a>QDir::isRoot () const<tt> [虚]</tt>
</h3>
如果目录是根目录，返回真，否则返回假。
<p> 注意：如果目录是一个连接到根目录的符号连接，这个函数返回假。如果你想测试这一点，你可以使用<a href="#canonicalPath">canonicalPath</a>()：
<p> 实例：
<pre>
    QDir d( "/tmp/root_link" );
    d = d.<a href="#canonicalPath">canonicalPath</a>();
    if ( d.<a href="#isRoot">isRoot</a>() )
        <a href="qapplication.html#qWarning">qWarning</a>( "It IS a root link!" );
  </pre>
 
<p> <p>也可以参考<a href="#root">root</a>()和<a href="#rootDirPath">rootDirPath</a>()。

<h3 class=fn>bool <a name="match"></a>QDir::match ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;filter, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;fileName )<tt> [静态]</tt>
</h3>
如果<em>fileName</em>与通配符模式<em>filter</em>匹配，返回真。<em>filter</em>也可以包含由空格或者分号分割的多个模式。
<p> （请参考<a href="qregexp.html#wildcard-matching">QRegExp通配符匹配</a>。）
<p>也可以参考<a href="qregexp.html#match">QRegExp::match</a>()。

<h3 class=fn>bool <a name="match-2"></a>QDir::match ( const&nbsp;<a href="qstringlist.html">QStringList</a>&nbsp;&amp;&nbsp;filters, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;fileName )<tt> [静态]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果<em>fileName</em>与列表<em>filters</em>中的通配符模式匹配，返回真。
<p> （请参考<a href="qregexp.html#wildcard-matching">QRegExp通配符匹配</a>。）
<p>也可以参考<a href="qregexp.html#match">QRegExp::match</a>()。

<h3 class=fn>bool <a name="matchAllDirs"></a>QDir::matchAllDirs () const
</h3>
返回由<a href="#setMatchAllDirs">setMatchAllDirs</a>()设置的值。
<p> <p>也可以参考<a href="#setMatchAllDirs">setMatchAllDirs</a>()。