Bloco de Função PREG_FILTER

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

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

Além do fato de que o bloco de função PREG_FILTER só retorna as cadeias de caracteres (possivelmente convertidas) em caso de correspondências, ele é idêntico ao bloco de função PREG_REPLACE.

Entrada PATTERN

A expressão como string que será procurada. Também estão disponíveis alguns modificadores PCRE.

Entrada REPLACEMENT

A cadeia de caracteres 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 um número segue diretamente uma referência de volta (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 volta. Por exemplo, \11 confundiria a função porque ela não sabe se você quer a referência de volta \1 seguida pelo número 1 ou apenas a referência de volta \11. Neste caso, a solução é usar ${1}1. Isso cria uma referência de volta 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 cadeias de caracteres com as quais as referências de volta serão substituídas. Isso é feito para garantir que não ocorram erros de sintaxe quando são usadas referências de volta que contêm aspas simples ou duplas. Certifique-se de conhecer a sintaxe da cadeia de caracteres para saber exatamente como a cadeia de caracteres avaliada se parece.

Entrada SUBJECT

A entrada define a cadeia de caracteres para procurar.

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 (possivelmente convertidas) forem encontradas, a nova cadeia de caracteres Q será retornada; caso contrário, SUBJECT será retornado inalterado ou NULL, se um erro ocorreu.

Saída COUNT

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