Uso e exemplo da função PHP preg_filter()

PHP Expressão Regular (PCRE)

preg_filter A função é usada para executar uma busca e substituição de expressão regular.

Sintaxe

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

preg_filter() é equivalente a preg_replace() ，mas ele retorna apenas os resultados correspondentes ao alvo.

Descrição dos parâmetros:

• $pattern：要搜索的模式。可以是字符串或字符串数组。
• $replacement：用于替换的字符串或字符串数组。
• $subject：要进行搜索和替换的字符串或字符串数组。
• $limit：opcional, número máximo de substituições por padrão para cada padrão em cada subject. O padrão é -1(infinito).
• $count：opcional, número de substituições concluídas.

Exemplo online

<?php
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4); 
$pattern = array('/\d/', '/[a-z]/', '/[1a]/); 
$replace = array('A:$0', 'B:$0', 'C:$0'); 
echo "Retorno de preg_filter:\n";
print_r(preg_filter($pattern, $replace, $subject)); 
echo "Retorno de preg_replace:\n";
print_r(preg_replace($pattern, $replace, $subject)); 
?>

O resultado da execução é como segue:

Retorno de preg_filter:
Array
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [7] => A:4
)
Retorno de preg_replace:
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
)

Pode-se ver que preg_filter retorna apenas os resultados correspondentes, e ignora os não correspondentes, enquanto preg_replace retorna os elementos 'A' 'B' não correspondentes também.

PHP Expressão Regular (PCRE)