GlobIterator::__construct

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

GlobIterator::__construct — Constrói um diretório usando glob

Descrição

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

Constrói um novo iterador de diretório a partir de uma expressão glob.

Parâmetros

pattern

Um padrão glob().

flags

Sinalizadores de opção, os sinalizadores podem ser uma máscara de bits das constantes FilesystemIterator.

Erros/Exceções

Lança uma UnexpectedValueException se o diretório definido em directory não existir.

Lança um ValueError se o diretório definido em directory for uma string vazia.

Registro de Alterações

Versão Descrição
8.0.0 Agora lança um ValueError se directory for uma string vazia; anteriormente lançava um RuntimeException.

Exemplos

Example #1 Exemplo de GlobIterator

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

if (!$iterator->count()) {
    echo 'Sem correspondência';
} else {
    $n = 0;

    printf("Corresponderam %d item(s)\r\n", $iterator->count());

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

O exemplo acima produzirá algo semelhante a:

Corresponderam 2 item(s)
[1] php5ts.dll
[2] php_gd2.dll

Veja Também