Fonction str_replace() de PHP

La fonction str_replace()


PHP references des fonctions PHP

 (PHP 4, PHP 5)

str_replace() — Remplace toutes les occurrences dans une chaîne

La fonction str_replace()

Définition et utilisation

La fonction str_replace() remplace quelques caractères par quelques autres caractères dans une chaîne.

La fonction str_replace() retourne une chaîne ou un tableau, dont toutes les occurrences de search dans subject ont été remplacées par replace.

Cette fonction suit les règles suivantes :

  • Si la chaîne à rechercher est un array (tableau), elle renvoie une array (tableau)
  • Si la chaîne à rechercher est un array (tableau), la trouvaille et remplacer est effectuée avec chaque élément de tableau
  • Si la trouvaille et remplacent sont des arrays (tableaux), et remplacent a peu d'éléments que la trouvaille, une chaîne vide sera employée comme remplacent
  • Si la trouvaille est un array (tableau) et remplace est une chaîne, la chaîne de remplacement sera employée pour chaque valeur de trouvaille
Syntaxe

              str_replace ($search , $replace , $subject ,
              compte)
           
 
Paramètre Description

search

Requis. Spécifie la valeur à chercher

replace

Requis.  La valeur de remplacement à substituer aux valeurs trouvées. Un tableau peut être utilisé pour désigner plusieurs valeurs de remplacement.

subject

Requis. La chaîne de caractères ou le tableau sur lequel on va effectuer la recherche et le remplacement. 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.  

compte

Facultatif. Une variable qui compte le nombre de remplacements


Note : Cette fonction distingue les majuscules et minuscules. Employez la fonction  str_ireplace() pour exécuter une recherche ne distinguant pas majuscules et minuscules.

Note : Si search et replace sont des tableaux, alors str_replace() prendra une valeur de chaque tableau, et l'utilisera pour faire le remplacement dans subject. Si replace a moins de valeurs que search, alors une chaîne vide sera utilisée pour effectuer les remplacements. Si search est un tableau et que replace est une chaîne, alors la chaîne de remplacement sera utilisée pour chaque élément de search. Cependant, l'inverse n'aurait aucun sens.

Si search ou replace sont des tableaux, les éléments sont traités du premier, au dernier.

Note: Cette fonction gère les chaînes binaires.


Exemple 1 Sélectionner le code

              <html>
              <body>
              <?php
               
              // Génère : Vous devez manger pizza, café, et des glasses chaque jour.
              $phrase  = "Vous devez manger des  fruits, vegetaux, et des fiberes chaque jour.";
              $healthy = array("fruits", "vegetaux", "fibere");
              $yummy   = array("pizza", "café", "glasses");
               
              $newphrase = str_replace($healthy, $yummy, $phrase, $count);
               
              echo "Phrase origine: ",$phrase, "<br />";
              echo "Nouvelle phrase: ",$newphrase, "<br />";
              echo "Nobmre de remplacement: ",$count;
               
              ?>
              </body>
              </html>
           
 

Exemple 2 Sélectionner le code

              <html>
              <body>
              <?php
              // Ordre des remplacements
              $chaine     = "Line 1\nLine 2\rLine 3\r\nLine 4\n";
              $order   = array("\r\n", "\n", "\r");
              $replace = '<br />';
               
              // Traitement du premier \r\n, ils ne seront pas convertis deux fois.
              $newstr = str_replace($order, $replace, $chaine);
               
              // Affiche F car A est remplacé par B, puis B est remplacé par C, et ainsi de
              suite...
              // Finalement, E est remplacé par F
              $search  = array('A', 'B', 'C', 'D', 'E');
              $replace = array('B', 'C', 'D', 'E', 'F');
              $subject = 'A';
              echo str_replace($search, $replace, $subject),"<br />";
               
              // Affiche : apearpearle pear
              // Pour les mêmes raisons que plus haut
              $letters = array('a', 'p');
              $fruit   = array('apple', 'pear');
              $text    = 'a p';
              $output  = str_replace($letters, $fruit, $text);
              echo $output;
              ?>
               
              </body>
              </html>
           
 


Par carabde 22 Aout 2014