Função PHP preg_replace()
Exemplo
Use uma expressão regular que não diferencia maiúsculas de minúsculas para substituir Microsoft por W3Schools em uma string:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
Definição e uso
A preg_replace()
função retorna uma string ou array de strings onde todas as correspondências de um padrão ou lista de padrões encontrados na entrada são substituídas por substrings.
Existem três maneiras diferentes de usar esta função:
1. Um padrão e uma string de substituição. As correspondências do padrão são substituídas pela string de substituição.
2. Uma matriz de padrões e uma string de substituição. As correspondências com qualquer um dos padrões são substituídas pela string de substituição.
3. Uma matriz de padrões e uma matriz de strings de substituição. As correspondências de cada padrão são substituídas pela string de substituição na mesma posição na matriz de substituições. Se nenhum item for encontrado nessa posição, a correspondência será substituída por uma string vazia.
Strings de substituição podem conter uma referência inversa na forma \n ou $n onde n é o índice de um grupo no padrão. Na string retornada, as instâncias de \n e $n serão substituídas pela substring que foi correspondida pelo grupo ou, se \0 ou $0 forem usados, pela expressão inteira.
Nota: Para cada string de entrada, a função avalia os padrões na ordem em que são fornecidos. O resultado da avaliação do primeiro padrão na string é usado como a string de entrada para o segundo padrão e assim por diante. Isso pode levar a um comportamento inesperado.
Sintaxe
preg_replace(patterns, replacements, input, limit, count)
Valores de parâmetro
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
Detalhes técnicos
Valor de retorno: | Retorna uma string ou uma matriz de strings resultantes da aplicação das substituições à string ou strings de entrada |
---|---|
Versão do PHP: | 4.0.5+ |
Registro de alterações: | PHP 5.1.0 - O parâmetro count foi adicionado |
❮ Referência PHP RegExp