Forum und email

dir

(PHP 4, PHP 5)

dir — Класс directory

Описание

dir
dir ( string $каталог )
string$path ;
resource$handle ;
string read ( void )
void rewind ( void )
void close ( void )

Псевдо-объектно-ориентированный механизм для чтения каталога, переданного в параметре каталог . С момента открытия каталога становятся доступными два свойства класса. Свойство "handle" может быть использовано с другими функциями для работы с каталогами, например, с функциями readdir(), rewinddir() и closedir(). Свойство "path" содержит путь к открытому каталогу. Доступны три метода: read, rewind and close.

Пожалуйста, обратите внимание на способ, которым осуществляется проверка значения, возвращаемого методами класса dir() в примере, приведенном ниже. В этом примере проводится проверка значения на идентичность (выражения идентичны, когда они равны и являются одного типа - за более подробной информацией обратитесь к главе Операторы сравнения) значению FALSE, поскольку в ином случае, любой элемент каталога, чье имя может быть выражено как FALSE, остановит цикл.

Example#1 Пример использования класса dir()

<?php
$d 
dir("/etc");
echo 
"Дескриптор: ".$d->handle."<br>\n";
echo 
"Путь: ".$d->path."<br>\n";
while (
false !== ($entry $d->read())) {
    echo 
$entry."<br>\n";
}
$d->close();
?>

Note: Порядок, в котором метод "read" возвращает элементы каталога, зависит от операционной системы.

Note: Такж