PHP-Fonctions: str_replace
str_replace
Remplace toutes les occurrences dans une chaîne.
Description :
str_replace(
array|string $search,
array|string $replace,
string|array $subject,
int &$count = null
): string|array
str_replace() retourne une chaîne ou un tableau, dont toutes les occurrences de search dans subject
ont été remplacées par replace.
Si vous n'avez pas besoin de règles de remplacement compliquées (comme les expressions rationnelles), cette fonction devrait être utilisé au lieu de preg_replace().
Liste de paramètres
Si les paramètres search et replace
sont des tableaux, alors la fonction str_replace() prendra une valeur de chaque tableau et les utilisera pour la recherche et le remplacement sur subject.
Si les paramètres replace a moins de valeurs que le paramètre search, alors une chaîne de caractères vide sera utilisée comme valeur pour le reste des valeurs de remplacement.
Si le paramètre search est un tableau et que le paramètre replace est une chaîne de caractères, alors cette chaîne de caractères de remplacement sera utilisée pour chaque valeur de search.
L'inverse n'a pas de sens.
Si search ou replace sont des tableaux, les éléments sont traités du premier, au dernier.
search
La valeur à chercher, autrement connue comme le masque. Un tableau peut être utilisé pour désigner plusieurs masques.
replace
La valeur de remplacement à substituer aux valeurs trouvées.
Un tableau peut être utilisé pour désigner plusieurs valeurs de remplacement.
subject
La chaîne de caractères ou le tableau sur lequel on va effectuer la recherche et le remplacement, aussi connu sous le nom de haystack.
Si subject est un tableau, alors le remplacement se fera sur chaque élément de celui-ci, et la valeur retournée sera aussi un tableau.
count
Si fournie, cette variable contiendra le nombre de remplacements effectués.
Valeurs de retour
Cette fonction retourne une chaîne, ou un tableau, contenant les valeurs remplacées.