preg_filter

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

preg_filter — Realiza una búsqueda y sustitución de una expresión regular

Descripción

preg_filter(
    mixed $pattern,
    mixed $replacement,
    mixed $subject,
    int $limit = -1,
    int &$count = ?
): mixed

preg_filter() es idéntica a preg_replace() excepto que sólo devuelve los sujetos (posiblemente tranformados) donde hubo una coincidencia. Los detalles de cómo trabaja esta función se encuentra en la documentación de preg_replace().

Valores devueltos

Devuelve un array si el parámetro subject es un array, de lo contrario devuelve un string.

Si no se encontraron coincidencias u ocurrió un error, se devuelve un array vacío cuando subject es un array o null de otro modo.

Ejemplos

Ejemplo #1 Ejemplo comparando preg_filter() con preg_replace()


<?php
$sujeto = array('1', 'a', '2', 'b', '3', 'A', 'B', '4'); 
$patrón = array('/\d/', '/[a-z]/', '/[1a]/'); 
$sustitución = array('A:$0', 'B:$0', 'C:$0'); 

echo "preg_filter devuelve\n";
print_r(preg_filter($patrón, $sustitución, $sujeto)); 

echo "preg_replace devuelve\n";
print_r(preg_replace($patrón, $sustitución, $sujeto)); 
?>

El resultado del ejemplo sería:

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
)

Ver también

Patrones de PCRE
preg_quote() - Escapar caracteres en una expresión regular
preg_replace() - Realiza una búsqueda y sustitución de una expresión regular
preg_replace_callback() - Realiza una búsqueda y sustitución de una expresión regular usando una llamada de retorno
preg_grep() - Devuelve entradas de matriz que coinciden con el patrón
preg_last_error() - Devuelve el código de error de la última ejecución de expresión regular de PCRE

＋add a note

User Contributed Notes 6 notes

down

bienvenunet at yahoo dot com ¶

5 years ago


If you don't want to actually replace the matches, just filter the array to them, make the replacement parameter '$0'.

<?php
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4'); 
$result = preg_filter('/\d/', '$0', $subject);  // ['1','2','3','4']
?>

down

forsoap at gmail dot com ¶

6 years ago


For those who read manual not in English and figure out that example code returns not the same result as in documentation

You need put in example patter modifier "u" to get same result:

<?php
$subject = array('1', 'а', '2', 'б', '3', 'А', 'Б', '4');
// Added "u"
$pattern = array('/\d/u', '/[а-я]/u', '/[1а]/u');
$replace = array('А:$0', 'Б:$0', 'В:$0');
?>

down

sajina_99 at hotmail dot de ¶

11 years ago


As I had to work with PHP5.2.X and needed preg_filter I wrote a quick and dirty workaround.

<?php
  if (!function_exists('preg_filter')) {
  
    function preg_filter($pattern, $replace, $subject, $limit = -1 , &$count = null) {
    
      if(!is_array($subject)) {
        $noArray = 1 ;
        $subject = array($subject);
      }

      $preg = preg_replace($pattern, $replace, $subject, $limit,  &$count);

      $diff = array_diff($preg, $subject);
      
      if($noArray == 1) $diff = implode($diff) ;

      return $diff ;
      
    }
    
  }
?>

down

-26

MrBertie ¶

12 years ago


Another way to filter an array, and simply return the matching items: preg_grep!

down

-27

fgmhhfg at gmail dot com ¶

9 years ago


As for the php 5.5.3 version, the example  turn out like:
Array
(
       [0] => A:1
       [1] => B:a
       ...
)

down

-36

Anonymous ¶

9 years ago


As for the php 5.5.3 version, the example will turn out like:
Array
(
       [0]=>A:1
       [1]=>B:a
       ...
)

＋add a note