PageRenderTime 25ms CodeModel.GetById 22ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.scandir.html

https://bitbucket.org/thncr/manuals
HTML | 224 lines | 184 code | 40 blank | 0 comment | 0 complexity | a284a2ac759412ec429fd4e069d7b7b6 MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>列出指定路径中的文件和目录</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="function.rewinddir.html">rewinddir</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="book.fileinfo.html">Fileinfo</a></div>
    11. 

  11.  <div class="up"><a href="ref.dir.html">Directory 函数</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="function.scandir" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">scandir</h1>
    16. 

  16.   <p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">scandir</span> &mdash; <span class="dc-title">列出指定路径中的文件和目录</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19. 

  20.  <div class="refsect1 description" id="refsect1-function.scandir-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="type">array</span> <span class="methodname"><strong>scandir</strong></span>
    24. 

  24.     ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$directory</code></span>
    25. 

  25.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$sorting_order</code></span>
    26. 

  26.    [, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$context</code></span>
    27. 

  27.   ]] )</div>
    28. 

  28. 

  29.   <p class="para rdfs-comment">
    30. 

  30.    返回一个 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>，包含有
    31. 

  31.    <em><code class="parameter">directory</code></em> 中的文件和目录。
    32. 

  32.   </p>
    33. 

  33. 

  34.  </div>
    35. 

  35. 

  36. 

  37.  <div class="refsect1 parameters" id="refsect1-function.scandir-parameters">
    38. 

  38.   <h3 class="title">参数</h3>
    39. 

  39.   <p class="para">
    40. 

  40.    <dl>
    41. 

  41. 

  42.     <dt>
    43. 

  43. 

  44.      <span class="term"><em><code class="parameter">directory</code></em></span>
    45. 

  45.      <dd>
    46. 

  46. 

  47.       <p class="para">
    48. 

  48.        要被浏览的目录
    49. 

  49.       </p>
    50. 

  50.      </dd>
    51. 

  51. 

  52.     </dt>
    53. 

  53. 

  54.     <dt>
    55. 

  55. 

  56.      <span class="term"><em><code class="parameter">sorting_order</code></em></span>
    57. 

  57.      <dd>
    58. 

  58. 

  59.       <p class="para">
    60. 

  60.        默认的排序顺序是按字母升序排列。如果使用了可选参数
    61. 

  61.        <em><code class="parameter">sorting_order</code></em>（设为
    62. 

  62.        1），则排序顺序是按字母降序排列。
    63. 

  63.       </p>
    64. 

  64.      </dd>
    65. 

  65. 

  66.     </dt>
    67. 

  67. 

  68.     <dt>
    69. 

  69. 

  70.      <span class="term"><em><code class="parameter">context</code></em></span>
    71. 

  71.      <dd>
    72. 

  72. 

  73.       <p class="para">
    74. 

  74.        <em><code class="parameter">context</code></em> 参数的说明见手册中的
    75. 

  75.        <a href="ref.stream.html" class="link">Streams API</a> 一章。
    76. 

  76.       </p>
    77. 

  77.      </dd>
    78. 

  78. 

  79.     </dt>
    80. 

  80. 

  81.    </dl>
    82. 

  82. 

  83.   </p>
    84. 

  84.  </div>
    85. 

  85. 

  86. 

  87.  <div class="refsect1 returnvalues" id="refsect1-function.scandir-returnvalues">
    88. 

  88.   <h3 class="title">返回值</h3>
    89. 

  89.   <p class="para">
    90. 

  90.    成功则返回包含有文件名的 <span class="type"><a href="language.types.array.html" class="type array">array</a></span>，如果失败则返回
    91. 

  91.    <strong><code>FALSE</code></strong>。如果 <em><code class="parameter">directory</code></em>
    92. 

  92.    不是个目录，则返回布尔值 <strong><code>FALSE</code></strong> 并生成一条
    93. 

  93.    <strong><code>E_WARNING</code></strong> 级的错误。
    94. 

  94.   </p>
    95. 

  95.  </div>
    96. 

  96. 

  97. 

  98.  <div class="refsect1 changelog" id="refsect1-function.scandir-changelog">
    99. 

  99.   <h3 class="title">更新日志</h3>
    100. 

  100.   <p class="para">
    101. 

  101.    <table class="doctable informaltable">
    102. 

  102.     
    103. 

  103.      <thead>
    104. 

  104.       <tr>
    105. 

  105.        <th>版本</th>
    106. 

  106.        <th>说明</th>
    107. 

  107.       </tr>
    108. 

  108. 

  109.      </thead>
    110. 

  110. 

  111.      <tbody class="tbody">
    112. 

  112.       <tr>
    113. 

  113.        <td>5.4.0</td>
    114. 

  114.        <td>
    115. 

  115.         <em><code class="parameter">sorting_order</code></em> now accepts constants. Any
    116. 

  116.         nonzero value caused descending order in previous versions.
    117. 

  117.        </td>
    118. 

  118.       </tr>
    119. 

  119. 

  120.      </tbody>
    121. 

  121.     
    122. 

  122.    </table>
    123. 

  123. 

  124.   </p>
    125. 

  125.  </div>
    126. 

  126. 

  127. 

  128.  <div class="refsect1 examples" id="refsect1-function.scandir-examples">
    129. 

  129.   <h3 class="title">范例</h3>
    130. 

  130.   <p class="para">
    131. 

  131.    <div class="example" id="example-2224">
    132. 

  132.     <p><strong>Example #1 一个简单的  <span class="function"><strong>scandir()</strong></span> 例子</strong></p>
    133. 

  133.     <div class="example-contents">
    134. 

  134. <div class="phpcode"><code><span style="color: #000000">
    135. 

  135. <span style="color: #0000BB">&lt;?php<br />$dir&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'/tmp'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$files1&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">scandir</span><span style="color: #007700">(</span><span style="color: #0000BB">$dir</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$files2&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">scandir</span><span style="color: #007700">(</span><span style="color: #0000BB">$dir</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$files1</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$files2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    136. 

  136. </span>
    137. 

  137. </code></div>
    138. 

  138.     </div>
    139. 

  139. 

  140.     <div class="example-contents"><p>以上例程的输出类似于：</p></div>
    141. 

  141.     <div class="example-contents screen">
    142. 

  142. <div class="cdata"><pre>
    143. 

  143. Array
    144. 

  144. (
    145. 

  145.     [0] =&gt; .
    146. 

  146.     [1] =&gt; ..
    147. 

  147.     [2] =&gt; bar.php
    148. 

  148.     [3] =&gt; foo.txt
    149. 

  149.     [4] =&gt; somedir
    150. 

  150. )
    151. 

  151. Array
    152. 

  152. (
    153. 

  153.     [0] =&gt; somedir
    154. 

  154.     [1] =&gt; foo.txt
    155. 

  155.     [2] =&gt; bar.php
    156. 

  156.     [3] =&gt; ..
    157. 

  157.     [4] =&gt; .
    158. 

  158. )
    159. 

  159. </pre></div>
    160. 

  160.     </div>
    161. 

  161.    </div>
    162. 

  162.   </p>
    163. 

  163.   <p class="para">
    164. 

  164.    <div class="example" id="example-2225">
    165. 

  165.     <p><strong>Example #2  <span class="function"><strong>scandir()</strong></span> 在 PHP 4 中的实现</strong></p>
    166. 

  166.     <div class="example-contents">
    167. 

  167. <div class="phpcode"><code><span style="color: #000000">
    168. 

  168. <span style="color: #0000BB">&lt;?php<br />$dir&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">"/tmp"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$dh&nbsp;&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">opendir</span><span style="color: #007700">(</span><span style="color: #0000BB">$dir</span><span style="color: #007700">);<br />while&nbsp;(</span><span style="color: #0000BB">false&nbsp;</span><span style="color: #007700">!==&nbsp;(</span><span style="color: #0000BB">$filename&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">readdir</span><span style="color: #007700">(</span><span style="color: #0000BB">$dh</span><span style="color: #007700">)))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$files</span><span style="color: #007700">[]&nbsp;=&nbsp;</span><span style="color: #0000BB">$filename</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">sort</span><span style="color: #007700">(</span><span style="color: #0000BB">$files</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$files</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">rsort</span><span style="color: #007700">(</span><span style="color: #0000BB">$files</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$files</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span>
    169. 

  169. </span>
    170. 

  170. </code></div>
    171. 

  171.     </div>
    172. 

  172. 

  173.     <div class="example-contents"><p>以上例程的输出类似于：</p></div>
    174. 

  174.     <div class="example-contents screen">
    175. 

  175. <div class="cdata"><pre>
    176. 

  176. Array
    177. 

  177. (
    178. 

  178.     [0] =&gt; .
    179. 

  179.     [1] =&gt; ..
    180. 

  180.     [2] =&gt; bar.php
    181. 

  181.     [3] =&gt; foo.txt
    182. 

  182.     [4] =&gt; somedir
    183. 

  183. )
    184. 

  184. Array
    185. 

  185. (
    186. 

  186.     [0] =&gt; somedir
    187. 

  187.     [1] =&gt; foo.txt
    188. 

  188.     [2] =&gt; bar.php
    189. 

  189.     [3] =&gt; ..
    190. 

  190.     [4] =&gt; .
    191. 

  191. )
    192. 

  192. </pre></div>
    193. 

  193.     </div>
    194. 

  194.    </div>
    195. 

  195.   </p>
    196. 

  196.  </div>
    197. 

  197. 

  198. 

  199.  <div class="refsect1 notes" id="refsect1-function.scandir-notes">
    200. 

  200.   <h3 class="title">注释</h3>
    201. 

  201.   <div class="tip"><strong class="tip">Tip</strong><p class="simpara">如已启用<a href="filesystem.configuration.html#ini.allow-url-fopen" class="link">fopen 包装器</a>，在此函数中， URL 可作为文件名。关于如何指定文件名详见  <span class="function"><a href="function.fopen.html" class="function">fopen()</a></span>。各种
    202. 

  202. wapper 的不同功能请参见 <a href="wrappers.html" class="xref">支持的协议和封装协议</a>，注意其用法及其可提供的预定义变量。</p></div>
    203. 

  203.  </div>
    204. 

  204. 

  205. 

  206.  <div class="refsect1 seealso" id="refsect1-function.scandir-seealso">
    207. 

  207.   <h3 class="title">参见</h3>
    208. 

  208.   <p class="para">
    209. 

  209.    <ul class="simplelist">
    210. 

  210.     <li class="member"> <span class="function"><a href="function.opendir.html" class="function" rel="rdfs-seeAlso">opendir()</a> - 打开目录句柄</span></li>
    211. 

  211.     <li class="member"> <span class="function"><a href="function.readdir.html" class="function" rel="rdfs-seeAlso">readdir()</a> - 从目录句柄中读取条目</span></li>
    212. 

  212.     <li class="member"> <span class="function"><a href="function.glob.html" class="function" rel="rdfs-seeAlso">glob()</a> - 寻找与模式匹配的文件路径</span></li>
    213. 

  213.     <li class="member"> <span class="function"><a href="function.is-dir.html" class="function" rel="rdfs-seeAlso">is_dir()</a> - 判断给定文件名是否是一个目录</span></li>
    214. 

  214.     <li class="member"> <span class="function"><a href="function.sort.html" class="function" rel="rdfs-seeAlso">sort()</a> - 对数组排序</span></li>
    215. 

  215.    </ul>
    216. 

  216.   </p>
    217. 

  217.  </div>
    218. 

  218. 

  219. </div><hr /><div class="manualnavbar" style="text-align: center;">
    220. 

  220.  <div class="prev" style="text-align: left; float: left;"><a href="function.rewinddir.html">rewinddir</a></div>
    221. 

  221.  <div class="next" style="text-align: right; float: right;"><a href="book.fileinfo.html">Fileinfo</a></div>
    222. 

  222.  <div class="up"><a href="ref.dir.html">Directory 函数</a></div>
    223. 

  223.  <div class="home"><a href="index.html">PHP Manual</a></div>
    224. 

  224. </div></body></html>
    225. 

  225.