(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
preg_replace_callback — Executa uma busca por expressão regular e substitui usando uma chamada de retorno
$pattern
,$callback
,$subject
,$limit
= -1,&$count
= null
,$flags
= 0 O comportamento desta função é quase idêntico ao da preg_replace(), exceto pelo fato que ao invés do parâmetro replacement
, deve-se especificar o parâmetro callback
.
pattern
A padrão usado para busca. Pode ser tanto uma string como um array de strings.
callback
Uma função de retorno que será chamada e passado um array dos elementos correspondentes na string subject
. A função deve retornar a string substituta. Esta é a assinatura da função de retorno:
Normalmente será necessária uma função callback
para preg_replace_callback() em apenas um lugar. Neste caso você pode-se usar uma função anônima para declarar a função de retorno dentro da chamada a preg_replace_callback(). Desta forma, todas as informações para a chamada estarão no mesmo lugar e não polui o espaço de nomes com um nome de função que não é usado em nenhum outro lugar.
Exemplo #1 preg_replace_callback() e função anônima
<?php
$fp = fopen("php://stdin", "r") or die("can't read stdin");
while (!feof($fp)) {
$line = fgets($fp);
$line = preg_replace_callback(
'|<p>\s*\w|',
function ($matches) {
return strtolower($matches[0]);
},
$line
);
echo $line;
}
fclose($fp);
?>
subject
A string ou array com strings para procurar e modificar.
limit
O máximo de possíveis substituições para cada padrão em cada string de subject
. O padrão é -1
(sem limite).
count
Se especificado, esta variável irá ser preenchida com o número de substituições feitas.
flags
flags
pode ser uma combinação das opções PREG_OFFSET_CAPTURE
e PREG_UNMATCHED_AS_NULL
, que influenciam o formato do array de correspondências. Veja a descrição em preg_match() para mais detalhes.
preg_replace_callback() retorna um array se o parâmetro subject
for um array, ou uma string caso contrário. Em erros o valor de retorno é null
.
Se ocorrer correspondência, a nova string será retornada, caso contrário subject
será retornada inalterada.
Se o padrão de expressão regular passado não for compilado para uma expressão regular válida, um E_WARNING
será emitido.
Versão | Descrição |
---|---|
7.4.0 | O parâmetro flags foi adicionado. |
Exemplo #2 Exemplo de preg_replace_callback()
<?php
// este texto foi usado em 2002
// se quisermos atualizá-lo para 2003
$text = "Dia da mentira é 01/04/2002\n";
$text.= "Último Natal foi em 25/12/2001\n";
// a chamada de retorno
function next_year($matches)
{
// como sempre: $matches[0] é a correspondência completa
O exemplo acima produzirá:
Dia da mentira é 01/04/2003 Último Natal foi em 25/12/2002
Exemplo #3 preg_replace_callback() usando estrutura recursiva para manipular código BB encapsulado
<?php
$input = "plain [indent] deep [indent] deeper [/indent] deep [/indent] plain";
function parseTagsRecursive($input)
{
$regex = '#\[indent]((?:[^[]|\[(?!/?indent])|(?R))+)\[/indent]#';
if (is_array($input)) {
$input = '<div style="margin-left: 10px">'.$input[1].'</div>';
}
return preg_replace_callback($regex, 'parseTagsRecursive', $input);
}
$output = parseTagsRecursive($input);
echo $output;
?>