preg_filter

preg_filter(string $pattern, string $replacement, string $subject, [int $limit], [int $count]): string
```php

`preg_filter` es idéntica a `preg_replace`, pero solo devuelve las ocurrencias encontradas (eventualmente transformadas). Para más detalles sobre el funcionamiento de esta función, véase `preg_replace`.

## Parámetros

Los parámetros están descritos en la documentación de `preg_replace`.

## Valores devueltos

Devuelve un `array` si el parámetro `subject` es de tipo `array` o una `string` en otro caso.

Si ninguna ocurrencia es encontrada o si ocurre un error, un `array` vacío será devuelto cuando el parámetro `subject` es un `array` o `null` en otro caso.

## Errores/Excepciones

Si el patrón regex pasado no se compila a una regex válida, se emite una `E_WARNING`.

## Ejemplos

Ejemplo de comparación de `preg_filter` con `preg_replace`

preg_filter devuelve
Array
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [7] => A:4
)
preg_replace devuelve
Array
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [5] => A
    [6] => B
    [7] => A:4
)