PHP
Referenzliste
readdir
Verzeichnis-Funktionen
Befehl:
string readdir ([ resource $dir_handle ] )
Parameter-Liste:
| Beschreibung | |
|---|---|
| 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. |
Beschreibung:
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.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Warnung:
Warnung:
Diese Funktion kann sowohl das boolsche
FALSE zurückliefern, als auch einen nicht-boolschen Wert, welcher zu FALSE ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalb den === Operator, um den Rückgabewert dieser Funktion zu überprüfen.Siehe auch:
readdir() - Beispiel:
Eingabe:
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 -- siehe Kapitel Vergleichs-Operatoren für weitere Informationen) zu FALSE ist, andernfalls würde jeder Verzeichnis-Eintrag, dessen Name als FALSE ausgewertet wird, das Durchlaufen der Schleife beenden (z.B. ein Verzeichnis namens "0").
<?php
if ($handle = opendir('/path/to/files')) {
echo "Directory handle: $handle\n";
echo "Files:\n";
/* Das ist der korrekte Weg, ein Verzeichnis zu durchlaufen. */
while (false !== ($file = readdir($handle))) {
echo "$file\n";
}
/* Dies ist der FALSCHE Weg, ein Verzeichnis zu durchlaufen. */
while ($file = readdir($handle)) {
echo "$file\n";
}
closedir($handle);
}
?>
Beschreibung:
Mit readdir() kann man sich den kompletten Inhalt eines Verzeichnisses (dir_handle) auflisten lassen. Die Dateien werden dabei unsortiert aufgef�hrt. Beachten Sie, dass auch "." und ".." aufgelistet werden. Wenn Sie das nicht w�nschen, m�ssen Sie die Ausgabe mit einer if-Abfrage sch�tzen.
readdir() - Beispiel 2:
Eingabe:
Listet alle Dateien des aktuellen Verzeichnisses auf und blendet dabei . und .. aus.
<?php
if ($handle = opendir('.')) {
while (false !== ($file = readdir($handle))) {
if ($file != "." && $file != "..") {
echo "$file\n";
}
}
closedir($handle);
}
?>
Verzeichnis-Funktionen