Руководство по PHP
Пред. |  | След.

# dir

(PHP 3, PHP 4, PHP 5)

dir -- Класс directory

## Описание

class 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`, остановит цикл.

Пример 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(); ?>`

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

> Замечание: Также, PHP автоматически определяет внутренний класс Directory, что означает, что вы не сможете определять собственные классы с таким же именем. За полным списком предопределенных классов обратитесь к главе Предопределенные классы.

Пред. | Начало | След.
chroot | Уровень выше | closedir