(PHP 4, PHP 5)
dir — 返回一個(gè) Directory 類實(shí)例
說明
Directory dir ( string$directory
[, resource $context
] )
以面向?qū)ο蟮姆绞皆L問目錄。打開
directory
參數(shù)指定的目錄。
參數(shù)
directory
被打開的目錄
context
Note: 在 PHP 5.0.0 中增加了對上下文(Context)的支持。有關(guān)上下文(Context)的說明參見 Streams。
返回值
成功的話,返回一個(gè) Directory 類實(shí)例, 參數(shù)錯(cuò)誤的情況下返回 NULL
,
其它錯(cuò)誤情況返回 FALSE
。
范例
Example #1 dir() 示例
請?zhí)貏e注意下面示例中 Directory::read() 函數(shù)返回值的判斷方式。
我們嚴(yán)格測試(值相等,并且類型相同,請參考
比較運(yùn)算符 )返回值等于 FALSE
,因?yàn)橛行┣闆r下,目錄名可能"等于" FALSE
,導(dǎo)致
跳出循環(huán)。
<?php
$d = dir("/etc/php5");
echo "Handle: " . $d->handle . "n";
echo "Path: " . $d->path . "n";
while (false !== ($entry = $d->read())) {
echo $entry."n";
}
$d->close();
?>
以上例程的輸出類似于:
Handle: Resource id #2 Path: /etc/php5 . .. apache cgi cli
注釋
Note:
目錄條目返回的順序依賴于系統(tǒng)。