Função preg_filter

A função preg_filter executa busca e substituição em uma string ou array de strings por expressão regular. Diferente de preg_replace, ela retorna apenas os elementos onde foi encontrada uma correspondência. O primeiro parâmetro aceita a expressão regular, o segundo - a string de substituição, o terceiro - a string ou array para processamento. No quarto parâmetro opcional pode-se definir o número máximo de substituições em cada elemento (por padrão -1, o que significa "sem limitações"). No quinto parâmetro opcional especifica-se a variável na qual será registrado o número de substituições realizadas.

Sintaxe

preg_filter(pattern, replacement, subject, [limit = -1], [count]);

Exemplo

Vamos substituir todos os dígitos na string pelo caractere 'X':

<?php
	$res = preg_filter('/\d/', 'X', 'a1b2c3');
	var_dump($res);
?>

Resultado da execução do código:

'aXbXcX'

Exemplo

Vamos processar um array de strings, substituindo dígitos por '#':

<?php
	$res = preg_filter('/\d/', '#', ['a1', 'b2', 'c', 'd4']);
	var_dump($res);
?>

Resultado da execução do código:

['a#', 'b#', 'd#']

Exemplo

Vamos demonstrar a diferença para preg_replace:

<?php
	$input = ['a1', 'b2', 'c', 'd4'];
	$res_filter = preg_filter('/\d/', '#', $input);
	$res_replace = preg_replace('/\d/', '#', $input);
	echo "Resultado do Filter: ";
	var_dump($res_filter);
	echo "Resultado do Replace: ";
	var_dump($res_replace);
?>

Resultado da execução do código:

Resultado do Filter: ['a#', 'b#', 'd#']
Resultado do Replace: ['a#', 'b#', 'c', 'd#']

Veja também

a função preg_replace,
que executa substituição por expressão regular
a função preg_match,
que verifica correspondência com uma expressão regular