readdir

(PHP 4, PHP 5, PHP 7, PHP 8)

readdir — Получает элемент каталога по его дескриптору

Описание

readdir(?resource $dir_handle = null): string|false

Возвращает имя следующего по порядку элемента каталога. Элементы возвращаются в том порядке, в котором они хранятся в файловой системе.

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

dir_handle
Дескриптор каталога (resource), ранее открытый функцией opendir(). Если дескриптор каталога не указан, используется последний дескриптор, открытый функцией opendir().

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

Возвращает имя элемента каталога в случае успешного выполнения или false, если возникла ошибка.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Список изменений

Версия Описание
8.5.0 Использование null для параметра dir_handle теперь не рекомендуется. Вместо этого следует явно указать последний открытый дескриптор каталога.
8.0.0 dir_handle теперь допускает значение null.

Примеры

Примеры смотрите в документации функции opendir().

Смотрите также

  • opendir() - Открывает дескриптор каталога
  • rewinddir() - Сбросить дескриптор каталога
  • closedir() - Закрывает дескриптор каталога
  • dir() - Возвращает экземпляр класса Directory
  • is_dir() - Определяет, указывает ли путь на каталог
  • glob() - Находит файловые пути, которые совпадают с шаблоном
  • scandir() - Получает список файлов и каталогов, расположенных по указанному пути