Fonction str_replace

La fonction str_replace recherche dans une chaîne un texte donné et le remplace par un autre. Le premier paramètre de la fonction accepte ce que l'on remplace, et le second - par quoi on le remplace. Il peut s'agir de deux chaînes ou de deux tableaux. Dans le second cas, les éléments correspondants d'un tableau seront remplacés par les éléments correspondants du second tableau (voir les exemples).

Syntaxe

phpstr_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array

Exemple

Remplaçons toutes les lettres 'a' par '!' :

php<?php
  echo str_replace('a', '!', 'abcabc');
?>

Résultat de l'exécution du code :

php'!bc!bc'

Exemple

Remplaçons toutes les lettres 'a' par 1, les lettres 'b' par 2, les lettres 'c' par 3 :

php<?php
  echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>

Résultat de l'exécution du code :

php'123123'

Exemple

Remplaçons les lettres données par un caractère commun spécifié :

php<?php
  echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>

Résultat de l'exécution du code :

php'!!!!!!'

Exemple

Effectuons le remplacement dans chaque élément du tableau :

php<?php
  $arr = ['abc', 'abc', 'abc'];
  $res = str_replace('a', '!', $arr);
  print_r($res);
?>

Résultat de l'exécution du code :

php['!bc', '!bc', '!bc']

Exemple

La casse est importante :

php<?php
  echo str_replace('a', '!', 'Abcabc');
?>

Résultat de l'exécution du code :

php'Abc!bc'

Voir aussi

  • la fonction str_ireplace,
    qui effectue une recherche et un remplacement insensibles à la casse
  • la fonction strtr,
    qui effectue également une recherche et un remplacement
  • la fonction substr_replace,
    qui découpe une partie d'une chaîne et la remplace par une autre