Bloco de Função PREG_REPLACE

O bloco de função PREG_REPLACE busca e substitui com expressões regulares.

Aviso: Esta função é Binary-Safe. Isso significa que caracteres UTF8 não podem ser manipulados diretamente.

Entrada PATTERN

A expressão como string, pela qual se busca. Também estão disponíveis alguns modificadores PCRE.

Entrada REPLACEMENT

A string para substituição. Esta pode conter referências na forma \n ou $n, sendo que esta última é preferível. Cada uma dessas referências será substituída pelo texto capturado pelo n-ésimo padrão de busca entre parênteses. n pode ter um valor de 0 a 99. \0 ou $0 referem-se ao texto que corresponde ao padrão de busca completo. Para obter o número do subpadrão de captura, as parênteses abertas são contadas a partir da esquerda para a direita começando com 1. Para usar uma barra invertida na substituição, ela deve ser duplicada "\\".

Se você deseja trabalhar com uma substituição em que uma referência de retorno é seguida diretamente por outro número (ou seja, imediatamente após a correspondência com um padrão de busca deve vir um número), não pode usar a notação \1 para sua referência de retorno. Por exemplo, \11 confundiria a função porque ela não sabe se você quer a referência de retorno \1 seguida pelo número 1 ou apenas a referência de retorno \11. Neste caso, a solução é usar ${1}1. Isso cria uma referência de retorno isolada $1 e o 1 permanece um símbolo de caractere.

Se você usar o modificador obsoleto e, esta função mascara alguns caracteres (ou seja, ', ", \ e NULL) nas strings com as quais as referências de retorno serão substituídas. Isso é feito para garantir que não ocorram erros de sintaxe quando são usadas referências de retorno que contêm aspas simples ou duplas. Certifique-se de conhecer a sintaxe da string para saber exatamente como a string avaliada será.

Entrada SUBJECT

A entrada define a string para buscar.

Entrada LIMIT

O número máximo possível de substituições para cada padrão de busca em cada subject. Valor padrão: -1 ou NULL (sem limite).

Saída Q

Se correspondências foram encontradas, a nova string Q é retornada; caso contrário, SUBJECT é retornado inalterado ou NULL, se um erro ocorreu.

Saída COUNT

A saída retorna o número de substituições realizadas.