Cria um novo RegexIterator

Descrição

public RegexIterator::__construct(
    Iterator $iterator,
    string $pattern,
    int $mode = RegexIterator::MATCH,
    int $flags = 0,
    int $pregFlags = 0
)

Cria um novo RegexIterator que filtra um Iterator usando uma expressão regular.

Parâmetros

iterator

O iterador ao qual aplicar este filtro de regex.

pattern

A expressão regular para fazer a correspondência.

mode

Modo de operação, consulte RegexIterator::setMode() para obter uma lista de modos.

flags

Opções especiais, consulte RegexIterator::setFlags() para obter uma lista de opções disponíveis.

pregFlags

As opções da expressão regular. Essas opções dependem do parâmetro de modo de operação:

**RegexIterator preg_flags**
modo de operação	opções disponíveis
`RegexIterator::ALL_MATCHES`	Veja preg_match_all().
`RegexIterator::GET_MATCH`	Veja preg_match().
`RegexIterator::MATCH`	Veja preg_match().
`RegexIterator::REPLACE`	nenhum.
`RegexIterator::SPLIT`	Veja preg_split().

Erros/Exceções

Lança uma InvalidArgumentException se o argumento pattern for inválido.

Exemplos

Example #1 Exemplo de RegexIterator::__construct()

Cria um novo RegexIterator que filtra todas as strings que começam com 'test'.

<?php
$arrayIterator = new ArrayIterator(array('test 1', 'another test', 'test 123'));
$regexIterator = new RegexIterator($arrayIterator, '/^test/');

foreach ($regexIterator as $value) {
    echo $value . "\n";
}
?>

O exemplo acima produzirá algo semelhante a:

test 1
test 123

Veja Também

preg_match() - Realiza uma correspondência com expressão regular
preg_match_all() - Realiza uma correspondência global de expressão regular
preg_replace() - Realiza uma pesquisa por uma expressão regular e substitui
preg_split() - Divide uma string com base em expressão regular