qdir.html

QT的帮助

        d.<a href="#setSorting">setSorting</a>( QDir::<a href="#SortSpec-enum">Size</a> | QDir::<a href="#SortSpec-enum">Reversed</a> );

        const QFileInfoList *list = d.<a href="#entryInfoList">entryInfoList</a>();
        QFileInfoListIterator it( *list );
        <a href="qfileinfo.html">QFileInfo</a> *fi;

        printf( "     Bytes Filename\n" );
        while ( (fi = it.current()) != 0 ) {
            printf( "%10li %s\n", fi-&gt;<a href="qfileinfo.html#size">size</a>(), fi-&gt;<a href="qfileinfo.html#fileName">fileName</a>()。latin1() );
            ++it;
        }
        return 0;
    }
  </pre>
 
<p>也可以参考<a href="io.html">输入/输出和网络</a>。

<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="FilterSpec-enum"></a>QDir::FilterSpec</h3> 
<p> 这个枚举变量描述的是QDir是如何选择目录中的哪些条目被返回的。被指定的过滤器的值可以由下述列表中的值或运算得到：
<ul>
<li><tt>QDir::Dirs</tt> - 只列出目录。
<li><tt>QDir::Files</tt> - 只列出文件。
<li><tt>QDir::Drives</tt> - 列出磁盘驱动器（在Unix下被忽略）。
<li><tt>QDir::NoSymLinks</tt> - 不列出符号连接（不支持符号连接的操作系统会忽略它）。
<li><tt>QDir::All</tt> - 列出目录、文件、驱动器和符号连接（除非你指定系统，这不会列出损坏的符号连接）。
<li><tt>QDir::TypeMask</tt> - Dirs、Files、Drives和NoSymLink的掩码。
<li><tt>QDir::Readable</tt> - 列出应用程序可以读访问的文件。
<li><tt>QDir::Writable</tt> - 列出应用程序可以写访问的文件。
<li><tt>QDir::Executable</tt> - 列出应用程序可以执行访问的文件。可执行需要由Dirs和Files组合。
<li><tt>QDir::RWEMask</tt> - Readable、Writable和Executable标记的掩码。
<li><tt>QDir::Modified</tt> - 只列出已经被修改的文件（在Unix下被忽略）。
<li><tt>QDir::Hidden</tt> - 列出隐藏文件（在Unix下就是以.开始的文件）。
<li><tt>QDir::System</tt> - 列出系统文件（在Unix下就是FIFO、套接字和设备文件）。
<li><tt>QDir::AccessMask</tt> - Readable、Writable、Executable、Modified、Hidden和System标记的掩码。
<li><tt>QDir::DefaultFilter</tt> - 内部标记
</ul><p> 如果你不设置<a href="#FilterSpec-enum">Readable</a>、<a href="#FilterSpec-enum">Writable</a>或<a href="#FilterSpec-enum">Executable</a>中的任何一个，QDir将会设置它们三个全部。这使得默认很容易写并且同时也很有用。
<p> 实例：<tt>Readable|Writable</tt>是指列出应用程序可以读访问、写访问或者两者都可以的所有文件。<tt>Dirs|Drives</tt>是指列出驱动器、目录、所有应用程序可以读、写、执行的文件并且也包括到这些文件/目录的符号连接。

<h3 class=fn><a name="SortSpec-enum"></a>QDir::SortSpec</h3> 
<p> 这个枚举变量描述的是QDir如何排列由<a href="#entryList">entryList</a>()或<a href="#entryInfoList">entryInfoList</a>()返回的条目。被指定的排列的值可以由下述列表中的值或运算得到：
<ul>
<li><tt>QDir::Name</tt> - 按名称排序。
<li><tt>QDir::Time</tt> - 按时间排序（修改时间）。
<li><tt>QDir::Size</tt> - 按文件大小排序。
<li><tt>QDir::Unsorted</tt> - 不排序。
<li><tt>QDir::SortByMask</tt> - Name、Time和Size的掩码。
<li><tt>QDir::DirsFirst</tt> - 首先是目录，然后是文件。
<li><tt>QDir::Reversed</tt> - 相反的排序顺序。
<li><tt>QDir::IgnoreCase</tt> - 不区分大小写进行排序。
<li><tt>QDir::DefaultSort</tt> - 内部标记。
</ul><p> 前四种中你只能指定一个。
<p> 如果你同时指定<a href="#SortSpec-enum">DirsFirst</a>和<a href="#SortSpec-enum">Reversed</a>，目录仍然会被放在前面，但是按照反向的顺序，文件仍然排在目录后面，当然也是按照反向的顺序。

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QDir"></a>QDir::QDir ()
</h3>
构造一个指向当前目录的QDir。
<p>也可以参考<a href="#currentDirPath">currentDirPath</a>()。

<h3 class=fn><a name="QDir-2"></a>QDir::QDir ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;path, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;nameFilter = QString::null, int&nbsp;sortSpec = Name | IgnoreCase, int&nbsp;filterSpec = All )
</h3>
构造一个路径为<em>path</em>、名称过滤器为<em>nameFilter</em>并且属性过滤器为<em>filterSpec</em>的QDir。它也使用<em>sortSpec</em>来排列名称。
<p> 默认的<em>nameFilter</em>是一个空字符串，不包含任何东西，默认的<em>filterSpec</em>是<a href="#FilterSpec-enum">All</a>，也就是说也不包含任何东西。默认的<em>sortSpec</em>是<tt>Name|IgnoreCase</tt>，也就是说不区分大小写按名称排序。
<p> 下面是列出“/tmp”中所有文件的实例：
<pre>
    QDir d( "/tmp" );
    for ( int i = 0; i &lt; d.<a href="#count">count</a>(); i++ )
        printf( "%s\n", d[i] );
  </pre>
 
<p> 如果<em>path</em>为“”或零，QDir使用“.”（当前目录）。如果<em>nameFilter</em>为“”或零，QDir使用“*”（所有文件）。
<p> 注意<em>path</em>不需要存在。
<p> <p>也可以参考<a href="#exists">exists</a>()、<a href="#setPath">setPath</a>()、<a href="#setNameFilter">setNameFilter</a>()、<a href="#setFilter">setFilter</a>()和<a href="#setSorting">setSorting</a>()。

<h3 class=fn><a name="QDir-3"></a>QDir::QDir ( const&nbsp;<a href="qdir.html">QDir</a>&nbsp;&amp;&nbsp;d )
</h3>
构造一个目录<em>d</em>的复制的QDir。
<p>也可以参考<a href="#operator-eq">operator=</a>()。

<h3 class=fn><a name="~QDir"></a>QDir::~QDir ()<tt> [虚]</tt>
</h3>
销毁QDir并且释放它的资源。

<h3 class=fn><a href="qstring.html">QString</a> <a name="absFilePath"></a>QDir::absFilePath ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;fileName, bool&nbsp;acceptAbsPath = TRUE ) const<tt> [虚]</tt>
</h3>
返回路径中一个文件的绝对路径名称。<em>不</em>检查这个文件是否真的存在于这个目录中。在<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="#filePath">filePath</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="absPath"></a>QDir::absPath () const<tt> [虚]</tt>
</h3>
返回绝对路径（一个由“/”或驱动器标识开始的路径），可能包含符号连接，但是不会包含“.”、“..”或者多个分隔符。
<p> <p>也可以参考<a href="#setPath">setPath</a>()、<a href="#canonicalPath">canonicalPath</a>()、<a href="#exists">exists</a>()、<a href="#cleanDirPath">cleanDirPath</a>()、<a href="#dirName">dirName</a>()和<a href="#absFilePath">absFilePath</a>()。
<p>实例：<a href="fileiconview-example.html#x807">fileiconview/qfileiconview.cpp</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="canonicalPath"></a>QDir::canonicalPath () const<tt> [虚]</tt>
</h3>
返回规范的路径，也就是没有符号连接或者多余的“.”、“..”元素的路径。
<p> 在没有符号连接的系统上，这个函数总是返回和absPath()返回值一样的值。如果规范路径不存在（通常是因为挂起的符号连接）。
<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="qstring.html#isNull">QString::isNull</a>()。

<h3 class=fn>bool <a name="cd"></a>QDir::cd ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;dirName, bool&nbsp;acceptAbsPath = TRUE )<tt> [虚]</tt>
</h3>
改变QDir的目录为<em>dirName</em>。
<p> 如果<em>acceptAbsPath</em>为真，由分隔符“/”开始的路径将会导致这个函数改变到这个绝对路径。如果<em>acceptAbsPath</em>为假，<em>dirName</em>前面的任何数量的分隔符都将被移除并且这个函数将会进入到<em>dirName</em>中。
<p> 如果新的路径存在并且是可读的，返回真。注意如果新的目录不存在，逻辑上的<a href="#cd">cd</a>()操作不会被执行。
<p> 调用cd( ".." )等于调用<a href="#cdUp">cdUp</a>()。
<p> <p>也可以参考<a href="#cdUp">cdUp</a>()、<a href="#isReadable">isReadable</a>()、<a href="#exists">exists</a>()和<a href="#path">path</a>()。
<p>实例：<a href="fileiconview-example.html#x879">fileiconview/mainwindow.cpp</a>。

<h3 class=fn>bool <a name="cdUp"></a>QDir::cdUp ()<tt> [虚]</tt>
</h3>
改变目录为QDir的当前目录的上一级目录。
<p> 如果新的路径存在并且是可读的，返回真。注意如果新的目录不存在，逻辑上的<a href="#cdUp">cdUp</a>()操作不会被执行。
<p> <p>也可以参考<a href="#cd">cd</a>()、<a href="#isReadable">isReadable</a>()、<a href="#exists">exists</a>()和<a href="#path">path</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="cleanDirPath"></a>QDir::cleanDirPath ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;filePath )<tt> [静态]</tt>
</h3>
移除<em>filePath</em>的多重目录分隔符“/”并且解析其中的“.”或者“..”。
<p> 符号连接会被保留。这个函数不返回规范路径，但会是输入的最简化的版本。“./local”变为“local”、“local/../bin”变为“bin”并且“/local/usr/../bin”变为“/local/bin”。
<p> <p>也可以参考<a href="#absPath">absPath</a>()和<a href="#canonicalPath">canonicalPath</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="convertSeparators"></a>QDir::convertSeparators ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;pathName )<tt> [静态]</tt>
</h3>
把<em>pathName</em>里面的“/”分隔符转化为适用于底层操作系统的分隔符。返回转化的字符串。
<p> 在Windows上，<a href="#convertSeparators">convertSeparators</a>("c:/winnt/system32")返回“c:\winnt\system32”。
<p> 在一些操作系统上，例如在Unix上，返回的字符串可能和参数是一样的。

<h3 class=fn>void <a name="convertToAbs"></a>QDir::convertToAbs ()<tt> [虚]</tt>
</h3>
把目录路经转化为绝对路径。如果它已经是绝对路径了，就什么也不做。
<p> <p>也可以参考<a href="#isRelative">isRelative</a>()。

<h3 class=fn>uint <a name="count"></a>QDir::count () const
</h3>
返回找到的目录和文件的数量。
<p> Equivalent to <a href="#entryList">entryList</a>()。<a href="#count">count</a>()。
<p>也可以参考<a href="#operator[]">operator[]</a>()和<a href="#entryList">entryList</a>()。

<h3 class=fn><a href="qdir.html">QDir</a> <a name="current"></a>QDir::current ()<tt> [静态]</tt>
</h3>
返回应用程序当前目录。
<p> 使用<a href="#path">path</a>()来访问QDir对象的路径。
<p>也可以参考<a href="#currentDirPath">currentDirPath</a>()和<a href="#QDir">QDir::QDir</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="currentDirPath"></a>QDir::currentDirPath ()<tt> [静态]</tt>
</h3>