RegexIterator::__construct
En esta página
RegexIterator::__construct
Crea un nuevo RegexIterator
Descripción#
public RegexIterator::__construct(Iterator $iterator, string $pattern, [int $mode], [int $flags], [int $pregFlags])
```php
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.
`pattern`
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.
`pregFlags`
Las flags de expresión regular. Estas flags dependen de el parámetro de modo de operación.
| 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`. |
`RegexIterator` preg_flags
## Errores/Excepciones
Lanza una `InvalidArgumentException` si el argumento `pattern` es inválido.
## Ejemplos
Ejemplo de `RegexIterator::__construct`
Crea un nuevo RegexIterator que filtra todos los string que empiezan con 'test'.
```php
Resultado del ejemplo anterior es similar a:
test 1
test 123
Véase también#
preg_match, preg_match_all, preg_replace, preg_split