GlobIterator::__construct

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

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

    Описание

    publicGlobIterator::__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() - Находит файловые пути, совпадающие с шаблоном
    To Top