PHP str_replace

Resumo : neste tutorial, você aprenderá como usar a str_replace()função PHP para substituir todas as ocorrências de uma substring por uma nova string

Introdução à função PHP str_replace()

A função PHP str_replace()retorna uma nova string com todas as ocorrências de uma substring substituídas por outra string.

O seguinte mostra a sintaxe da str_replace()função:

str_replace ( 
    array|string $search , 
    array|string $replace , 
    string|array $subject , 
    int &$count = null 
) : string|arrayLinguagem de código:  PHP  ( php )

O str_replace()possui os seguintes parâmetros:

• The $searché uma substring a ser substituída.
• The $replaceé a string de substituição que substitui o $searchvalor.
• A $subjecté a string de entrada
• O $countretorna o número de substituições que a função executou. O $counté opcional.

Se os argumentos $searche forem arrays , pegará cada valor do array (da esquerda para a direita) e o substituirá por cada valor do array.$replacestr_replace()$search$replace

Se o $replacearray tiver menos elementos que o $searcharray, a str_replace()função usará uma string vazia para os valores de substituição.

Se the $searchfor um array e the $replacefor uma string, a str_replace()função substituirá todos os elementos de the $searchpela $replacestring.

Observe que str_replace()não altera a string de entrada ( $subject). Ele retorna um novo array com o $searchsubstituído pelo $replace.

str_replace()Exemplos de funções PHP

Vejamos alguns exemplos de uso da str_replace()função PHP.

str_replace()Exemplos simples de funções PHP

O exemplo a seguir usa a str_replace()função para substituir a string 'Hello'por 'Hi'string 'Hello there':

<?php

$str = 'Hello there';
$new_str = str_replace('Hello', 'Hi', $str);

echo $new_str . '<br>'; // Hi there

echo $str . '<br>'; // Hello thereLinguagem de código:  PHP  ( php )

Saída:

Hi there
Hello thereLinguagem de código:  PHP  ( php )

Conforme mostrado na saída, o str_replace()não altera a string de entrada, mas retorna uma nova string com a substring 'Hello'substituída pela string 'Hi';

O exemplo a seguir usa a str_replace()função para substituir a substring 'bye'pela string 'hey'na string 'bye bye bye':

<?php

$str = 'bye bye bye';
$new_str = str_replace('bye', 'hey', $str);

echo $new_str; // hey hey heyLinguagem de código:  PHP  ( php )

Saída:

hey hey heyLinguagem de código:  PHP  ( php )

Função PHP str_replace()com exemplo de argumento de contagem

O exemplo a seguir usa a str_replace()função com o argumento count:

<?php 

$str = 'Hi, hi, hi';
$new_str = str_replace('hi', 'bye', $str, $count);

echo $count; // 2Linguagem de código:  PHP  ( php )

Neste exemplo, a str_replace()função substitui a substring 'hi'pela string 'bye'na string 'Hi, hi, hi'.

A contagem retorna dois porque a str_replace()função substitui apenas a substring 'hi'not 'Hi'.

str_replace()Função PHP com exemplo de múltiplas substituições

O exemplo a seguir usa a str_replace()função para substituir foxwith wolfe dogwith catna string 'The quick brown fox jumps over the lazy dog':

<?php

$str = 'The quick brown fox jumps over the lazy dog';
$animals = ['fox', 'dog'];
$new_animals = ['wolf', 'cat'];

$new_str = str_replace($animals, $new_animals, $str);

echo $new_str;Linguagem de código:  PHP  ( php )

Saída:

The quick brown wolf jumps over the lazy catLinguagem de código:  PHP  ( php )

Como a str_replace()função substitui da esquerda para a direita, ela pode substituir o valor substituído anteriormente ao fazer várias substituições. Por exemplo:

<?php

$str = 'apple';

$fruits = ['apple', 'orange', 'banana'];
$replacements = ['orange', 'banana', 'strawberry'];

$new_str = str_replace($fruits, $replacements, $str, $count);

echo $new_str; // strawberry
echo $count; // 3Linguagem de código:  PHP  ( php )

Neste exemplo, o barbante maçã é substituído por laranja, a laranja é substituída por banana e a banana é substituída por morango. A string retornada é morango.

Função PHP str_ireplace()

Para procurar uma string sem distinção entre maiúsculas e minúsculas e substituí-la por uma string de substituição, você usa a str_ireplace()função. Por exemplo:

<?php

$str = 'Hi, hi, hi';
$new_str = str_ireplace('hi', 'bye', $str, $count);

echo $new_str; // bye, bye, byeLinguagem de código:  PHP  ( php )

Neste exemplo, a str_ireplace()função substitui a substring 'hi'ou 'Hi'pela string 'bye'.

Resumo

• Use a str_replace()função para substituir uma substring por outra string.
• Use a str_ireplace()função para pesquisar uma substring sem distinção entre maiúsculas e minúsculas e substituí-la por outra string.