Создаёт итератор директории, используя glob-выражение

# GlobIterator::__construct

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

GlobIterator::__construct — Создаёт итератор директории, используя glob-выражение

### Описание

public function GlobIterator::__construct(string `$pattern`, int `$flags` = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)

Создаёт новый итератор директории на основе glob-выражения.

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

`pattern`

  Шаблон glob().

`flags`

  Флаги настроек. Флаги можно задавать битовой маской констант FilesystemIterator.

### Ошибки

Выбрасывает исключение UnexpectedValueException, если директория `directory` не существует.

Выбрасывает исключение ValueError, если параметр `directory` содержит пустую строку.

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

Версия | Описание
--- | ---
8.0.0 | Теперь выбрасывает исключение ValueError, если параметр `directory` содержит пустую строку. Ранее выбрасывалось исключение RuntimeException.

### Примеры

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

    <?php
    $iterator = new GlobIterator('*.dll', FilesystemIterator::KEY_AS_FILENAME);

    if (!$iterator->count()) {
        echo 'Нет совпадений';
    } else {
        $n = 0;

        printf("Найдено элементов: %d \r\n", $iterator->count());

        foreach ($iterator as $item) {
            printf("[%d] %s\r\n", ++$n, $iterator->key());
        }
    }
    ?>

Вывод приведённого примера будет похож на:

    Найдено элементов: 2
    [1] php5ts.dll
    [2] php_gd2.dll

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

- DirectoryIterator::__construct() - Создаёт новый итератор каталогов из пути
- GlobIterator::count() - Определяет количество директорий и файлов
- glob() - Находит файловые пути, которые совпадают с шаблоном

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open