Function.readdir
Aus PHP-Wiki
readdir — Liest einen Eintrag aus einem Verzeichnis-Handle
Inhaltsverzeichnis |
Beschreibung
string readdir ([ resource $dir_handle ] )
Gibt den Dateinamen des nächsten Files des Verzeichnisses zurück. Die
Dateinamen werden in der Reihenfolge zurück gegeben, in der sie innerhalb
des Filesystems angelegt wurden.
Parameter-Liste
- dir_handle
- Das Verzeichnis-Handle resource, das zuvor mit opendir() geöffnet wurde. Wenn das Verzeichnis-Handle nicht angegeben ist, wird dasjenige verwendet, das auf das zuletzt mittels opendir() geöffnete Verzeichnis zeigt.
Rückgabewerte
Gibt bei Erfolg den Dateinamen zurück, im Fehlerfall FALSE.
WarnungDiese Funktion kann sowohl das
Boolsche FALSE zurückliefern, als auch einen nicht-Boolschen Wert, wie zum
Beispiel0 oder "". der von einem einfachen
if-Statement als FALSE ausgewertet wird. Weitere Informationen entnehmen Sie
bitte dem Abschnitt über die
Boolsche Typen. Benutzen Sie deshalb
den === Operator
um den Rückgabewert dieser Funktion zu überprüfen.
Beispiele
=== #1 Alle Dateien eines Verzeichnisses auflisten
Bitte beachten Sie die Art und Weise, in der die Rückgabewerte von
readdir() in untenstehenden Beispielen geprüft werden.
Wir testen explizit, ob der Rückgabewert identisch (also inhaltlich und
typgleich===
<source lang="php">
<?php
if ($handle = opendir('.')) {
while (false !== ($file = readdir($handle))) {
if ($file != "." && $file != "..") {
echo "$file\n";
}
}
closedir($handle);
}
?>