readdir

(PHP 3, PHP 4, PHP 5)

readdir -- 從目錄識別碼中讀取條目

說明

string readdir ( resource dir_handle )

返回目錄中下一個檔案的檔案名。檔案名以在檔案系統中的排序返回。

參數

dir_handle

目錄識別碼的 resource,之前由 opendir() 開啟

返回值

成功則返回檔案名,失敗返回 FALSE

範例

例子 1. 列出目錄中的所有檔案

請留意下面例子中檢查 readdir() 返回值的風格。這裡明確地測試返回值是否全等於(值和類型都相同--更多訊息參見比較運算符FALSE,否則任何目錄項的名稱求值為 FALSE 的都會導致迴圈停止(例如一個目錄名為「0」)。

<?php
// 注意在 4.0.0-RC2 之前不存在 !== 運算符

if ($handle opendir('/path/to/files')) {
    echo 
"Directory handle: $handle\n";
    echo 
"Files:\n";

    
/* 這是正確地遍歷目錄方法 */
    
while (false !== ($file readdir($handle))) {
        echo 
"$file\n";
    }

    
/* 這是錯誤地遍歷目錄的方法 */
    
while ($file readdir($handle)) {
        echo 
"$file\n";
    }

    
closedir($handle);
}
?>

例子 2. 列出現用的目錄的所有檔案並去掉 ...

<?php
if ($handle opendir('.')) {
    while (
false !== ($file readdir($handle))) {
        if (
$file != "." && $file != "..") {
            echo 
"$file\n";
        }
    }
    
closedir($handle);
}
?>