dir

(PHP 3, PHP 4, PHP 5)

dir -- Verzeichnis-Klasse

Beschreibung:

class dir {

dir ( string directory )

string path

resource handle

string read ( void )

void rewind ( void )

void close ( void )

}

Ein Pseudo-Objekt-Orientierter Mechanismus zum Lesen eines Verzeichnisses. Das per directory angegebene Verzeichnis wird geöffnet. Sobald das Verzeichnis geöffnet ist, stehen 2 Eigenschaften zur Verfügung. Die Eigenschaft Handle kann mit anderen Verzeichnis-Funktionen wie readdir(), rewinddir() und closedir() benutzt werden (Handles sind Verweise auf Einträge in einer internen Tabelle zur Verwaltung von Objekten). Die Eigenschaft Path enthält die Pfadangabe des geöffneten Verzeichnisses. Es sind 3 Methoden verfügbar: read, rewind und close.

Beachten Sie im nachfolgenden Beispiel, wie der Rückgabewert der Funktion dir() überprüft wird. Es wird explizit getestet, ob der Rückgabewert identisch (den gleichen Wert und Datentyp hat, siehe Vergleichs-0peratoren) mit FALSE ist, weil sonst jeder Verzeichniseintrag, der zu FALSE ausgewertet wird, die Schleife abbricht.

Beispiel 1. dir()-Beispiel:

<?php
$d
= dir("/etc");
echo
"Handle: " . $d->handle . "<br />\n";
echo
"Path: " . $d->path . "<br />\n";
while (
false !== ($entry = $d->read())) {
   echo
$entry."<br />\n";
}
$d->close();
?>

Anmerkung: Die Reihenfolge der Verzeichniseinträge, die von der read-Methode zurückgegeben werden, ist systemabhängig.

Anmerkung: Hierdurch wird die interne Klasse Directory definiert, was bedeutet, dass Sie keine eigenen Klassen mit diesem Namen definieren können. Eine vollständige Liste der vordefinierten Klassen in PHP gibt es unter Vordefinierte Klassen.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:56:57