Section courante

A propos

Section administrative du site

STRTR

Chaînes de caractères à remplacer
PHP 4+

Syntaxe

function strtr($str,$from,$to);
function strtr($str,$replace_pairs);

Paramètres

Nom Description
$str Ce paramètre permet d'indiquer une chaîne de caractères à traiter
$from Ce paramètre permet d'indiquer des caractères a rechercher dans la chaîne de caractères.
$to Ce paramètre permet d'indiquer des caractères a remplacer dans la chaîne de caractères.
$replace_pairs Ce paramètre permet d'indiquer une tableau de clef et de valeur dans lequel chaque clef trouvé sera remplacer par sa valeur dans la chaîne de caractères. Exemple: «echo strtr("Hello world", array("hello" => "Bonjour", "world" => "le monde"));»

Retour

Valeur Description
FALSE Cette valeur permet d'indiquer qu'une des valeurs de clefs est vides et qu'il n'est donc pas possible d'effectuer le traitement.
NULL Cette valeur permet d'indiquer que le paramètre str$ n'est pas d'un type de données scalaire valide.
chaîne de caractères Ces valeurs permettent d'indiquer la chaîne de caractères str$ avec les remplacements spécifiés.

Description

Cette fonction permet d'effectuer des remplacements de certaines caractères par d'autres caractères dans une chaîne de caractères. Si la fonction strtr est appelé avec 3 paramètres, alors la fonction retournera la chaîne de caractères indiquer par le paramètre $str après avoir remplacé chacun des caractères mentionné dans la chaîne de caractères du paramètre $from par son équivalent du paramètre $to (étant situé à la même position dans la chaîne de caractères que dans la chaîne de caractères du paramètre $from). Par conséquent l'occurrence $from[$n] sera remplacé par $to[$n]. Si la fonction strtr est appelé avec 2 paramètres, alors la fonction utilisera le deuxième paramètre, soit un tableau (array) pour effectuer des remplacements en utilisant la clef comme chaîne de caractères à rechercher et la valeur comme résultat de remplacement.

Remarques

Exemples

Voici un exemple d'une utilisation typique de cette fonction :

  1. <?php
  2. echo strtr("Hello world", array("Hello" => "Bonjour", "world" => "le monde")) . "<br />";
  3. echo "strtr(\"64.6\",\".\",\",\") = " . strtr("64.6",".",",") . "<br />";
  4. echo "strtr(\"M. Maltais\",\"M.\",\"Monsieur\") = " . strtr("M. Maltais","M.","Monsieur") . "<br />";
  5. ?>

on obtiendra le résultat suivant :

Bonjour le monde
strtr("64.6",".",",") = 64,6
strtr("M. Maltais","M.","Monsieur") = Mo Maltais

Voici un exemple permet de remplacer les caractères avec des accents par leur équivalence HTML :

  1. <?php
  2. $messageAccent = "Message avec des accents : áâäàã,ç,éêëè,íîïì,œ,óôöò,ÁÂÄÀ,Ç,ÉÊËÈ,ÍÎÌÏ,Œ,ÓÔÖÒ";
  3. echo strtr($messageAccent, array(
  4.             "á" => "&aacute;", "â" => "&acirc;", "ä" => "&auml;", "à" => "&agrave;", "ã" => "&atilde;",
  5.             "ç" => "&ccedil;",
  6.             "é" => "&eacute;", "ê" => "&ecirc;", "ë" => "&euml;", "è" => "&egrave;",
  7.             "í" => "&iacute;", "î" => "&icirc;", "ï" => "&iuml;", "ì" => "&igrave;", 
  8.             "œ" => "&oelig;",
  9.             "ó" => "&oacute;", "ô" => "&ocirc;", "ö" => "&ouml;", "ò" => "&ograve;",
  10.             "Á" => "&Agrave;", "Â" => "&Acirc;", "Ä" => "&Auml;", "À" => "&Agrave;",
  11.             "Ç" => "&Ccedil;",
  12.             "É" => "&Eacute;", "Ê" => "&Ecirc;", "Ë" => "&Euml;", "È" => "&Egrave;", 
  13.             "Í" => "&Iacute;", "Î" => "&Icirc;", "Ï" => "&Iuml;", "Ì" => "&Igrave;", 
  14.             "Œ" => "&OElig;",
  15.             "Ó" => "&Oacute;", "Ô" => "&Ocirc;", "Ö" => "&Ouml;", "Ò" => "&Ograve;", 
  16.             )
  17.     );
  18. ?>

on obtiendra le résultat suivant :

Message avec des accents : áâäàã,ç,éêëè,íîïì,œ,óôöò,ÀÂÄÀ,Ç,ÉÊËÈ,ÍÎÌÏ,Œ,ÓÔÖÒ

Voici un exemple permet de remplacer les caractères avec des accents par leur lettre équivalente :

  1. <?php
  2. $messageAccent = "Message avec des accents : áâäàã,ç,éêëè,íîïì,óôöò,ÁÂÄÀ,Ç,ÉÊËÈ,ÍÎÌÏ,ÓÔÖÒ";
  3. echo strtr($messageAccent, 
  4.             "\xe1\xc1\xe0\xc0\xe2\xc2\xe4\xc4\xe3\xc3\xe5\xc5\xaa\xe7".
  5.             "\xc7\xe9".
  6.             "\xc9\xe8\xc8\xea\xca\xeb\xcb\xed".
  7.             "\xcd\xec\xcc\xee\xce\xef\xcf\xf1".
  8.             "\xd1\xf3".
  9.             "\xd3\xf2\xd2\xf4\xd4\xf6\xd6\xf5\xd5\x8\xd8\xba\xf0".
  10.             "\xfa\xda\xf9\xd9\xfb\xdb\xfc\xdc".
  11.             "\xfd\xdd\xff".
  12.             "\xe6\xc6\xdf",
  13.             "aAaAaAaAaAaAa".
  14.             "cC".
  15.             "eEeEeEeE".
  16.             "iIiIiIiI".
  17.             "nN".
  18.             "oOoOoOoOoOoOoo".
  19.             "uUuUuUuU".
  20.             "yYy".
  21.             "aAs"
  22.         );
  23. ?>

on obtiendra le résultat suivant :

Message avec des accents : aaaaa,c,eeee,iiii,oooo,AAAA,C,EEEE,IIII,OOOO

Dernière mise à jour : Samedi, le 27 décembre 2014