(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
iconv — Convertit une chaîne de caractères à partir d'un encodage vers un autre
Description
iconv(string
$from_encoding
, string
$to_encoding
, string
$string
): string|false
Liste de paramètres
-
from_encoding
-
L'encodage utilisé pour interpréter string
.
-
to_encoding
-
L'encodage souhaité du resultat.
Si la chaîne //TRANSLIT
est ajoutée au paramètre
to_encoding
, alors la translittération est activée.
Cela signifie que lorsqu'un caractère ne peut être représenté dans le jeu
de caractères cible, il pourrait être représenté approximativement à partir
d'un ou plusieurs caractères représentant le même caractère.
Si la chaîne //IGNORE
est ajoutée, les caractères
ne pouvant être représentés dans le jeu de caractères cible seront
tout simplement ignorés. Sinon, une alerte de niveau
E_NOTICE
sera générée et la fonction retournera
false
.
Attention
Si et comment //TRANSLIT
fonctionne exactement dépend
de l'implémentation iconv() du système (cf. ICONV_IMPL
).
Certaines implémentation sont connues pour ignorer //TRANSLIT
,
donc la conversion de caractères illégaux échouera probablement pour
to_encoding
.
-
string
-
La chaîne de caractères à convertir.
Valeurs de retour
Retourne la chaîne de caractères convertie, ou false
si une erreur survient.
Exemples
Exemple #1 Exemple avec iconv()
<?php
$text = "Ceci est le symbole de l'Euro '€'.";
echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Brut : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>
Résultat de l'exemple ci-dessus est similaire à :
Original : Ceci est le symbole de l'Euro '€'.
TRANSLIT : Ceci est le symbole de l'Euro 'EUR'.
IGNORE : Ceci est le symbole de l'Euro ''.
Brut : Ceci est le symbole de l'Euro '
Notice: iconv(): Detected an illegal character in input string in /Users/macbook/Desktop/- on line 8
Ceci est le symbole de l'Euro '
Notes
Note:
L'encodage de caractères et les options disponibles dépende de l'implémentation d'iconv.
Si l'argument de from_encoding
ou to_encoding
n'est
pas pris en charge sur le système actuel, false
sera retourné.
Voir aussi
- mb_convert_encoding() - Convertir une chaîne d'un codage de caractères à un autre
- uconverter::transcode() - Convertit une chaîne depuis un jeu de caractères vers un autre jeu de caractères