qdir.html

QT的帮助

<h3 class=fn>bool <a name="mkdir"></a>QDir::mkdir ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;dirName, bool&nbsp;acceptAbsPath = TRUE ) const<tt> [虚]</tt>
</h3>
创建一个目录。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的<em>dirName</em>将会被不改变地立即返回。如果<em>acceptAbsPath</em>为假，<em>dirName</em>的开始的任意个分隔符将被移除。
<p> 如果成功，返回真，否则返回假。
<p> <p>也可以参考<a href="#rmdir">rmdir</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="nameFilter"></a>QDir::nameFilter () const
</h3>
返回由<a href="#setNameFilter">setNameFilter</a>()设置的字符串。

<h3 class=fn>bool <a name="operator!-eq"></a>QDir::operator!= ( const&nbsp;<a href="qdir.html">QDir</a>&nbsp;&amp;&nbsp;d ) const<tt> [虚]</tt>
</h3>
如果目录<em>d</em>和这个目录是不同的路径或者不同的排序或过滤器设置，返回真，否则返回假。
<p> 实例：
<pre>
    // 当前目录为“/usr/local”
    QDir d1( "/usr/local/bin" );
    QDir d2( "bin" );
    if ( d1 != d2 ) <a href="qapplication.html#qDebug">qDebug</a>( "They differ\n" ); // 这是被打印的
    </pre>
 
<h3 class=fn><a href="qdir.html">QDir</a>&nbsp;&amp; <a name="operator-eq"></a>QDir::operator= ( const&nbsp;<a href="qdir.html">QDir</a>&nbsp;&amp;&nbsp;d )
</h3>
完成一个QDir <em>d</em>的复制并且把它赋给这个QDir。

<h3 class=fn><a href="qdir.html">QDir</a>&nbsp;&amp; <a name="operator-eq-2"></a>QDir::operator= ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;path )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 设置这个目录的路径为给定的<em>path</em>。

<h3 class=fn>bool <a name="operator-eq-eq"></a>QDir::operator== ( const&nbsp;<a href="qdir.html">QDir</a>&nbsp;&amp;&nbsp;d ) const<tt> [虚]</tt>
</h3>
如果目录<em>d</em>和这个目录有相同的路径、相同的排序和过滤器，返回真，否则返回假。
<p> 实例：
<pre>
    // 当前目录为“/usr/local”
    QDir d1( "/usr/local/bin" );
    QDir d2( "bin" );
    d2.<a href="#convertToAbs">convertToAbs</a>();
    if ( d1 == d2 ) <a href="qapplication.html#qDebug">qDebug</a>( "They're the same\n" ); // 这是被打印的
    </pre>
 
<h3 class=fn><a href="qstring.html">QString</a> <a name="operator[]"></a>QDir::operator[] ( int&nbsp;index ) const
</h3>
返回在文件名列表的<em>index</em>位置的文件名。等于<a href="#entryList">entryList</a>().at(index)。
<p> 如果<em>index</em>超出范围或者entryList()函数失败，返回一个零字符串。
<p> <p>也可以参考<a href="#count">count</a>()和<a href="#entryList">entryList</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="path"></a>QDir::path () const<tt> [虚]</tt>
</h3>
返回这个路径，这也许包含符号连接，但决不会包含多余的“.”、“..”或者多重分隔符。
<p> 返回的路径可能是相对的也可能是绝对的（请参考<a href="#setPath">setPath</a>()）。
<p> <p>也可以参考<a href="#setPath">setPath</a>()、<a href="#absPath">absPath</a>()、<a href="#exists">exists</a>()、<a href="#cleanDirPath">cleanDirPath</a>()、<a href="#dirName">dirName</a>()、<a href="#absFilePath">absFilePath</a>()和<a href="#convertSeparators">convertSeparators</a>()。

<h3 class=fn>bool <a name="remove"></a>QDir::remove ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;fileName, bool&nbsp;acceptAbsPath = TRUE )<tt> [虚]</tt>
</h3>
移除文件。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的路径将会移除使用绝对路径的文件。如果<em>acceptAbsPath</em>为假，<em>fileName</em>开始的任意个分隔符将被移除并且结果文件将被移除。
<p> 如果文件移除成功，返回真，否则返回假。

<h3 class=fn>bool <a name="rename"></a>QDir::rename ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;oldName, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;newName, bool&nbsp;acceptAbsPaths = TRUE )<tt> [虚]</tt>
</h3>
重命名一个文件或目录。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的路径将会重命名使用绝对路径的文件。如果<em>acceptAbsPath</em>为假，<em>fileName</em>开始的任意个分隔符将被移除并且结果文件将被重命名。
<p> 如果成功，返回真，否则返回假。
<p> 在绝大多数文件系统中，只有在<em>oldName</em>不存在或者<em>newName</em>和<em>oldName</em>不在同一个分区中，<a href="#rename">rename</a>()才会失败。在Windows下，如果<em>newName</em>已经存在，rename()将会失败。无论如何，还有其它几个原因导致rename()失败。例如，例如在文件系统中如果newName指向一个打开的文件，rename()会失败。
<p>实例：<a href="fileiconview-example.html#x810">fileiconview/qfileiconview.cpp</a>。

<h3 class=fn>bool <a name="rmdir"></a>QDir::rmdir ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;dirName, bool&nbsp;acceptAbsPath = TRUE ) const<tt> [虚]</tt>
</h3>
移除一个目录。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的路径将会移除使用绝对路径的目录。如果<em>acceptAbsPath</em>为假，<em>dirName</em>开始的任意个分隔符将被移除并且结果目录将被移除。
<p> 为了使<a href="#rmdir">rmdir</a>()成功，这个目录必须为空。
<p> 如果成功，返回真，否则返回假。
<p> <p>也可以参考<a href="#mkdir">mkdir</a>()。

<h3 class=fn><a href="qdir.html">QDir</a> <a name="root"></a>QDir::root ()<tt> [静态]</tt>
</h3>
返回根目录。
<p>也可以参考<a href="#rootDirPath">rootDirPath</a>()和<a href="#drives">drives</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="rootDirPath"></a>QDir::rootDirPath ()<tt> [静态]</tt>
</h3>
返回根目录的绝对路径。
<p> 在Unix操作系统这个返回“/”。在Windows文件系统这个返回“C:/”。
<p> <p>也可以参考<a href="#root">root</a>()和<a href="#drives">drives</a>()。

<h3 class=fn>char <a name="separator"></a>QDir::separator ()<tt> [静态]</tt>
</h3>
返回本地目录分隔符，在Unix下是“/”，在MS-DOS、Windows NT和OS/2下是“&#92;”，在Mac OS下是“:”。
<p> 你不需要这个函数来构建文件路径。如果你一直使用“/”，Qt将会把你的路径转化为符合底层操作系统的路径的。

<h3 class=fn>bool <a name="setCurrent"></a>QDir::setCurrent ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;path )<tt> [静态]</tt>
</h3>
设置你的应用程序的当前工作目录为<em>path</em>。如果目录被成功改变，返回真，否则返回假。

<h3 class=fn>void <a name="setFilter"></a>QDir::setFilter ( int&nbsp;filterSpec )<tt> [虚]</tt>
</h3>
设置被<a href="#entryList">entryList</a>()和<a href="#entryInfoList">entryInfoList</a>()使用的过滤器为<em>filterSpec</em>。过滤器被用来指定entryList()和entryInfoList()返回哪些文件。请参考<a href="#FilterSpec-enum">QDir::FilterSpec</a>。
<p> <p>也可以参考<a href="#filter">filter</a>()和<a href="#setNameFilter">setNameFilter</a>()。

<h3 class=fn>void <a name="setMatchAllDirs"></a>QDir::setMatchAllDirs ( bool&nbsp;enable )<tt> [虚]</tt>
</h3>
如果<em>enable</em>为真，那么所有的目录被包含（例如在<a href="#entryList">entryList</a>()中），并且<a href="#nameFilter">nameFilter</a>()仅适用于文件。如果<em>enable</em>为假，那么nameFilter()同时适用于文件和目录。
<p> <p>也可以参考<a href="#matchAllDirs">matchAllDirs</a>()。

<h3 class=fn>void <a name="setNameFilter"></a>QDir::setNameFilter ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter )<tt> [虚]</tt>
</h3>
设置<a href="#entryList">entryList</a>()和<a href="#entryInfoList">entryInfoList</a>()使用的名称过滤器为<em>nameFilter</em>。
<p> <em>nameFilter</em>是一个可以理解“*”和“?”的通配符过滤器。（请参考<a href="qregexp.html#wildcard-matching">QRegExp通配符匹配</a>。）你可以使用单个空格“ ”或者分号“;”来分割几个过滤器条目。
<p> 例如，如果你想entryList()和entryInfoList()列出所有以“.cpp”和“.h”结尾的文件，你需要使用dir.<a href="#setNameFilter">setNameFilter</a>("*.cpp *.h")或dir.setNameFilter("*.cpp;*.h")。
<p> <p>也可以参考<a href="#nameFilter">nameFilter</a>()和<a href="#setFilter">setFilter</a>()。

<h3 class=fn>void <a name="setPath"></a>QDir::setPath ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;path )<tt> [虚]</tt>
</h3>
设置目录的路径为<em>path</em>。这个路径被清除多余的“.”、“..”和多重分隔符。不会完成检查来确保这个路径的目录是否存在。
<p> 路径可以是相对的也可以是绝对的。绝对路径是由目录分隔符“/”或驱动器标识开始的（除了Unix下）。相对路径是一个指定了相对于当前目录的目录名称和文件名称。一个绝对路径的实例是“/tmp/quartz”，一个相对路径的实例是“src/fatlib”。
<p> <p>也可以参考<a href="#path">path</a>()、<a href="#absPath">absPath</a>()、<a href="#exists">exists</a>()、<a href="#cleanDirPath">cleanDirPath</a>()、<a href="#dirName">dirName</a>()、<a href="#absFilePath">absFilePath</a>()、<a href="#isRelative">isRelative</a>()和<a href="#convertToAbs">convertToAbs</a>()。

<h3 class=fn>void <a name="setSorting"></a>QDir::setSorting ( int&nbsp;sortSpec )<tt> [虚]</tt>
</h3>
设置<a href="#entryList">entryList</a>()和<a href="#entryInfoList">entryInfoList</a>()使用的排序顺序。
<p> <em>sortSpec</em>是由<a href="#SortSpec-enum">QDir::SortSpec</a>中的枚举变量的值或运算得到。

<p> <p>也可以参考<a href="#sorting">sorting</a>()和<a href="#SortSpec-enum">SortSpec</a>。

<h3 class=fn><a href="qdir.html#SortSpec-enum">SortSpec</a> <a name="sorting"></a>QDir::sorting () const
</h3>
<p> 返回由<a href="#setSorting">setSorting</a>()设置的值。
<p> <p>也可以参考<a href="#setSorting">setSorting</a>()和<a href="#SortSpec-enum">SortSpec</a>。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>