readdir
(PHP 4, PHP 5, PHP 7)
readdir — ディレクトリハンドルからエントリを読み込む
説明
string readdir
([ resource
$dir_handle
] )ディレクトリから次のエントリの名前を返します。 エントリ名はファイルシステム上に格納されている順番で返されます。
パラメータ
返り値
成功した場合にエントリ名、失敗した場合に FALSE を返します。
例
例1 ディレクトリ内の全てのエントリのリストを得る
以下の例で、readdir() の返り値をどのように調べているかに
注目してください。返り値が FALSE と一致することを、明示的に
（値が等しく、かつ型も等しい - 詳細は
比較演算子 を参照ください）調べています。なぜなら、そうしないと
FALSE と評価されてしまうディレクトリエントリ
（例: "0" という名前のディレクトリ）があった場合にループが
とまってしまうからです。
<?php
if ($handle = opendir('/path/to/files')) {
echo "Directory handle: $handle\n";
echo "Entries:\n";
/* ディレクトリをループする際の正しい方法です */
while (false !== ($entry = readdir($handle))) {
echo "$entry\n";
}
/* ディレクトリをループする際の「間違った」方法です */
while ($entry = readdir($handle)) {
echo "$entry\n";
}
closedir($handle);
}
?>
例2 カレントディレクトリの全てのエントリを一覧する。ただし . および .. は取り除く
<?php
if ($handle = opendir('.')) {
while (false !== ($entry = readdir($handle))) {
if ($entry != "." && $entry != "..") {
echo "$entry\n";
}
}
closedir($handle);
}
?>
忘却曲線を使ってこの関数を確実に記憶に残す
