Documentación offline PHP master

RegexIterator::__construct

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

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