(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_convert_encoding — Convertir una cadena de un codificación de caracteres a otra
$string
, string $to_encoding
, array|string|null $from_encoding
= null
): array|string|false
Convierte la string
desde from_encoding
,
o la codificación interna actual, a to_encoding
.
Opcionalmente desde from_encoding
.
Si string
es un tableau, todos sus valores chaîne de caractères
serán convertidos recursivamente.
string
La chaîne de caractères o tableau a convertir.
to_encoding
La codificación deseada del resultado.
from_encoding
La codificación actual utilizada para interpretar la string
.
Múltiples codificaciones pueden ser especificadas en forma de array (tableau) o lista separada por comas.
En este caso, la codificación correcta será adivinada utilizando el
mismo algoritmo que mb_detect_encoding().
Si from_encoding
es omitido o null
, el
parámetro mbstring.internal_encoding
será utilizado si está definido, de lo contrario el parámetro default_charset será utilizado.
Ver codificaciones soportadas
para los valores válidos de to_encoding
y from_encoding
.
La chaîne de caractères o tableau codificado en caso de éxito, o false
en caso de error.
A partir de PHP 8.0.0, una ValueError es lanzada si la
valor de to_encoding
o
from_encoding
es una codificación inválida.
Anterior a PHP 8.0.0, una E_WARNING
era emitida en su lugar.
Versión | Descripción |
---|---|
8.2.0 |
mb_convert_encoding() ya no devolverá
las siguientes codificaciones no textuales:
"Base64" , "QPrint" ,
"UUencode" , "HTML entities" ,
"7 bit" y "8 bit" .
|
8.0.0 |
mb_convert_encoding() lanzará ahora una
ValueError cuando
to_encoding es pasado una codificación inválida.
|
8.0.0 |
mb_convert_encoding() lanzará ahora una
ValueError cuando
from_encoding es pasado una codificación inválida.
|
8.0.0 |
from_encoding ahora es nullable.
|
7.2.0 |
Esta función ahora acepta un tableau como
string .
Anteriormente, solo las chaîne de caractères eran soportadas.
|
Ejemplo #1 Ejemplo con mb_convert_encoding()
<?php
/* Convierte la codificación interna a SJIS */
$str = mb_convert_encoding($str, "SJIS");
/* Convierte EUC-JP a UTF-7 */
$str = mb_convert_encoding($str, "UTF-7", "EUC-JP");
/* Detecta automáticamente una codificación entre JIS, eucjp-win o sjis-win,
Luego convierte a UCS-2LE */
$str = mb_convert_encoding($str, "UCS-2LE", "JIS, eucjp-win, sjis-win");
/* Si mbstring.language es "Japanese", "auto" es extendido a "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
$str = mb_convert_encoding($str, "EUC-JP", "auto");
?>