mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-10-11 00:43:20 +08:00
0.0.1
This commit is contained in:
fofolee
110
docs/php/readdir.html
Normal file
110
docs/php/readdir.html
Normal file
@@ -0,0 +1,110 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
||||
<title>从目录句柄中读取条目</title>
|
||||
</head>
|
||||
<body class="docs"><div id="layout">
|
||||
<div id="layout-content"><div id="function.readdir" class="refentry">
|
||||
<div class="refnamediv">
|
||||
<h1 class="refname">readdir</h1>
|
||||
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">readdir</span> — <span class="dc-title">从目录句柄中读取条目</span></p>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="refsect1 description" id="refsect1-function.readdir-description">
|
||||
<h3 class="title">说明</h3>
|
||||
<div class="methodsynopsis dc-description">
|
||||
<span class="methodname"><strong>readdir</strong></span>
|
||||
([ <span class="methodparam"><span class="type">resource</span> <code class="parameter">$dir_handle</code></span>
|
||||
] ) : <span class="type">string</span></div>
|
||||
|
||||
<p class="para rdfs-comment">
|
||||
返回目录中下一个文件的文件名。文件名以在文件系统中的排序返回。
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 parameters" id="refsect1-function.readdir-parameters">
|
||||
<h3 class="title">参数</h3>
|
||||
<p class="para">
|
||||
<dl>
|
||||
|
||||
|
||||
<dt>
|
||||
<code class="parameter">dir_handle</code></dt>
|
||||
|
||||
<dd>
|
||||
|
||||
<p class="para">
|
||||
目录句柄的 <span class="type"><a href="language.types.resource.html" class="type resource">resource</a></span>，之前由
|
||||
<span class="function"><a href="opendir.html" class="function">opendir()</a></span> 打开
|
||||
</p>
|
||||
</dd>
|
||||
|
||||
|
||||
</dl>
|
||||
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 returnvalues" id="refsect1-function.readdir-returnvalues">
|
||||
<h3 class="title">返回值</h3>
|
||||
<p class="para">
|
||||
成功则返回文件名 或者在失败时返回 <strong><code>FALSE</code></strong>
|
||||
</p>
|
||||
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">此函数可能返回布尔值
|
||||
<strong><code>FALSE</code></strong>，但也可能返回等同于 <strong><code>FALSE</code></strong> 的非布尔值。请阅读 <a href="language.types.boolean.html" class="link">布尔类型</a>章节以获取更多信息。应使用
|
||||
<a href="language.operators.comparison.html" class="link">===
|
||||
运算符</a>来测试此函数的返回值。</p></div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 examples" id="refsect1-function.readdir-examples">
|
||||
<h3 class="title">范例</h3>
|
||||
<p class="para">
|
||||
<div class="example" id="example-2752">
|
||||
<p><strong>Example #1 列出目录中的所有文件</strong></p>
|
||||
<div class="example-contents"><p>
|
||||
请留意下面例子中检查 <span class="function"><strong>readdir()</strong></span>
|
||||
返回值的风格。这里明确地测试返回值是否全等于（值和类型都相同——更多信息参见<a href="language.operators.comparison.html" class="link">比较运算符</a>）<strong><code>FALSE</code></strong>，否则任何目录项的名称求值为
|
||||
<strong><code>FALSE</code></strong> 的都会导致循环停止（例如一个目录名为“0”）。
|
||||
</p></div>
|
||||
<div class="example-contents">
|
||||
<div class="phpcode"><pre><span style="color: #000000">
|
||||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// 注意在 4.0.0-RC2 之前不存在 !== 运算符<br /><br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">$handle </span><span style="color: #007700">= </span><span style="color: #0000BB">opendir</span><span style="color: #007700">(</span><span style="color: #DD0000">'/path/to/files'</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">"Directory handle: </span><span style="color: #0000BB">$handle</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">"Files:\n"</span><span style="color: #007700">;<br /><br /> </span><span style="color: #FF8000">/* 这是正确地遍历目录方法 */<br /> </span><span style="color: #007700">while (</span><span style="color: #0000BB">false </span><span style="color: #007700">!== (</span><span style="color: #0000BB">$file </span><span style="color: #007700">= </span><span style="color: #0000BB">readdir</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">))) {<br /> echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$file</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br /> }<br /><br /> </span><span style="color: #FF8000">/* 这是错误地遍历目录的方法 */<br /> </span><span style="color: #007700">while (</span><span style="color: #0000BB">$file </span><span style="color: #007700">= </span><span style="color: #0000BB">readdir</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$file</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br /> }<br /><br /> </span><span style="color: #0000BB">closedir</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?></span>
|
||||
</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</p>
|
||||
<p class="para">
|
||||
<div class="example" id="example-2753">
|
||||
<p><strong>Example #2 列出当前目录的所有文件并去掉 <em>.</em> 和 <em>..</em></strong></p>
|
||||
<div class="example-contents">
|
||||
<div class="phpcode"><pre><span style="color: #000000">
|
||||
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">$handle </span><span style="color: #007700">= </span><span style="color: #0000BB">opendir</span><span style="color: #007700">(</span><span style="color: #DD0000">'.'</span><span style="color: #007700">)) {<br /> while (</span><span style="color: #0000BB">false </span><span style="color: #007700">!== (</span><span style="color: #0000BB">$file </span><span style="color: #007700">= </span><span style="color: #0000BB">readdir</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">))) {<br /> if (</span><span style="color: #0000BB">$file </span><span style="color: #007700">!= </span><span style="color: #DD0000">"." </span><span style="color: #007700">&& </span><span style="color: #0000BB">$file </span><span style="color: #007700">!= </span><span style="color: #DD0000">".."</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$file</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br /> }<br /> }<br /> </span><span style="color: #0000BB">closedir</span><span style="color: #007700">(</span><span style="color: #0000BB">$handle</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?></span>
|
||||
</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 seealso" id="refsect1-function.readdir-seealso">
|
||||
<h3 class="title">参见</h3>
|
||||
<p class="para">
|
||||
<ul class="simplelist">
|
||||
<li class="member"><span class="function"><a href="is_dir.html" class="function" rel="rdfs-seeAlso">is_dir()</a> - 判断给定文件名是否是一个目录</span></li>
|
||||
<li class="member"><span class="function"><a href="glob.html" class="function" rel="rdfs-seeAlso">glob()</a> - 寻找与模式匹配的文件路径</span></li>
|
||||
<li class="member"><span class="function"><a href="opendir.html" class="function" rel="rdfs-seeAlso">opendir()</a> - 打开目录句柄</span></li>
|
||||
<li class="member"><span class="function"><a href="scandir.html" class="function" rel="rdfs-seeAlso">scandir()</a> - 列出指定路径中的文件和目录</span></li>
|
||||
</ul>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
</div></div></div></body></html>
|
||||
Reference in New Issue
Block a user