dir

dir -- Klasa obsługi katalogów

Opis

class dir {

dir ( string katalog )

string path

resource handle

string read ( void )

void rewind ( void )

void close ( void )

}

Pseudo obiektowo zorientowany mechanizm czytania katalogu. Podany katalog zostaje otwarty. Gdy katalog zostaje otwarty dostępne są dwie właściwości. Właściwość handle może zostać użyta z innymi funkcjami takimi jak: readdir(), rewinddir() oraz closedir(). Właściwość path określa ścieżke do aktualnie otwartego katalogu. Dostępne są również trzy metody: read, rewind oraz close.

Sposób w jaki zwrócona przez dir() wartość powinna być sprawdzona, obrazuje poniższy przykład. Należy sprawdzić czy zwrócona wartość jest równa (jest tego samego typu -- zobacz również Comparison Operators) FALSE. W przeciwnym razie plik o nazwie FALSE (jak również "0") znajdujący się w czytanym katalogu zatrzymał by pętle.

Przykład 1. Przykład użycia dir()

<?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();
?>

Powyższy przykład wyświetli coś podobnego do:

Handle: Resource id #2
Path: /etc/php5
.
..
apache
cgi
cli

Notatka: Kolejność w jakiej zostają zwrócone kolejne pliki czytanego katalogu, podczas korzystania z metody read jest zależna od systemu plików.

Notatka: dir definiuje wewnętrzną klase Directory, co oznacza że nie można samemu zdefiniować klasy o tej nazwie. Zobacz również lista wszystkich predefiniowanych klas w PHP Predefined Classes.

Hosting by: Hurra Communications Sp. z o.o.
Generated: 2007-01-26 18:02:40