Crea un nuevo RegexIterator

Descripción

public RegexIterator::__construct ( Iterator $iterator , string $regex [, int $mode = self::MATCH [, int $flags = 0 [, int $preg_flags = 0 ]]] )

Crea un nuevo RegexIterator que filtra un Iterator usando una expresión regular.

Parámetros

iterator

El iterador al que se le va a aplicar el filtro regex.

regex

la expresión regular a coincidir.

mode

Modo de operación, véase RegexIterator::setMode() para una lista de todos los modos.

flags

Flags especiales, véase RegexIterator::setFlags() para una lista de todas las flags disponibles.

preg_flags

Las flags de expresión regular. Estas flags dependen de el parámetro de modo de operación.

**RegexIterator preg_flags**
operation mode	available flags
`RegexIterator::ALL_MATCHES`	Véase preg_match_all().
`RegexIterator::GET_MATCH`	Véase preg_match().
`RegexIterator::MATCH`	Véase preg_match().
`RegexIterator::REPLACE`	Nada.
`RegexIterator::SPLIT`	Véase preg_split().

Errores/Excepciones

Lanza una InvalidArgumentException si el argumento regex es inválido.

Ejemplos

Ejemplo #1 Ejemplo de RegexIterator::__construct()

Crea un nuevo RegexIterator que filtra todos los string que empiezan con 'test'.


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

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

El resultado del ejemplo sería algo similar a:

test 1
test 123

Ver también

preg_match() - Realiza una comparación con una expresión regular
preg_match_all() - Realiza una comparación global de una expresión regular
preg_replace() - Realiza una búsqueda y sustitución de una expresión regular
preg_split() - Divide un string mediante una expresión regular