Возвращает экземпляр класса Directory


(PHP 4, PHP 5)

dirВозвращает экземпляр класса Directory

Описание

Directory dir ( string $directory [, resource $context ] )

Псевдо-объектно-ориентированный механизм для чтения каталога. Переданный параметром directory каталог открывается.

Список параметров

directory

Каталог для открытия

context

Замечание: Поддержка контекста была добавлена в PHP 5.0.0. Для описания контекстов смотрите раздел Потоки.

Возвращаемые значения

Возвращает экземпляр класса Directory, NULL при неверных параметрах, и FALSE в случае другой ошибки.

Примеры

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

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

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

Результатом выполнения данного примера будет что-то подобное:

 Дескриптор: Resource id #2 Путь: /etc/php5 . .. apache cgi cli 

Примечания

Замечание:

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