mb_convert_encoding

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_convert_encodingConversion d'encodage

Description

mb_convert_encoding(array|string $string, string $to_encoding, array|string|null $from_encoding = null): array|string|false

Convertit l'encodage de caractères de string en to_encoding optionnellement depuis from_encoding. Si string est un tableau, toutes ses valeurs chaîne de caractères seront convertit récursivement.

Liste de paramètres

string

La chaîne de caractères ou tableau à encoder.

to_encoding

Le type d'encodage auquel string est converti.

from_encoding

Spécifié par le nom de code des caractères, avant la conversion. C'est soit un tableau, soit une liste d'éléments séparés par une virgule. Si from_encoding n'est pas spécifié, l'encodage interne sera utilisé.

Voir les encodages supportés.

Valeurs de retour

La chaîne de caractères ou tableau encodé en cas de succès, ou false si une erreur survient.

Erreurs / Exceptions

À partir de PHP 8.0.0, une ValueError est lancé si la valeur de to_encoding ou from_encoding est un encodage invalide. Antérieur à PHP 8.0.0, une E_WARNING était émise à la place.

Historique

Version Description
8.0.0 mb_convert_encoding() lancera désormais une ValueError quand to_encoding est passé un encodage invalide.
8.0.0 mb_convert_encoding() lancera désormais une ValueError quand from_encoding est passé un encodage invalide.
8.0.0 from_encoding est désormais nullable.
7.2.0 Cette fonction accepte désormais un tableau en tant que string. Auparavant, seulement les chaîne de caractères étaient supportées.

Exemples

Exemple #1 Exemple avec mb_convert_encoding()

<?php
/* Convertit l'encodage interne vers SJIS */
$str mb_convert_encoding($str"SJIS");

/* Convertit EUC-JP en UTF-7 */
$str mb_convert_encoding($str"UTF-7""EUC-JP");

/* Détecte automatiquement un encodage entre JIS, eucjp-win ou sjis-win,
   Puis convertit en UCS-2LE */
$str mb_convert_encoding($str"UCS-2LE""JIS, eucjp-win, sjis-win");

/* "auto" signifie "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
$str mb_convert_encoding($str"EUC-JP""auto");
?>

Voir aussi