(PHP 5 >= 5.2.0, PHP 7, PHP 8)
RegexIterator::__construct — Cria um novo RegexIterator
$iterator,$pattern,$mode = RegexIterator::MATCH,$flags = 0,$pregFlags = 0Cria um novo RegexIterator que filtra um Iterator usando uma expressão regular.
iteratorO iterador ao qual aplicar este filtro de regex.
patternA expressão regular para fazer a correspondência.
modeModo de operação, consulte RegexIterator::setMode() para obter uma lista de modos.
flagsOpções especiais, consulte RegexIterator::setFlags() para obter uma lista de opções disponíveis.
pregFlagsAs opções da expressão regular. Essas opções dependem do parâmetro de modo de operação:
| 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(). |
Lança uma InvalidArgumentException se o argumento pattern for inválido.
Exemplo #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