(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
iconv — Convierte una cadena de caracteres de un encodaje a otro
Convierte la cadena string
desde from_encoding
hacia el encodaje to_encoding
.
from_encoding
El encodaje utilizado para interpretar string
.
to_encoding
El encodaje deseado del resultado.
Si la cadena //TRANSLIT
es añadida al argumento
to_encoding
, entonces la transliteración es activada.
Esto significa que cuando un carácter no puede ser representado en el juego
de caracteres destino, podría ser representado aproximadamente a partir
de uno o varios caracteres que representen el mismo carácter.
Si la cadena //IGNORE
es añadida, los caracteres
que no puedan ser representados en el juego de caracteres destino serán
simplemente ignorados. De lo contrario, se generará una alerta de nivel
E_NOTICE
y la función retornará
false
.
Si y cómo //TRANSLIT
funciona exactamente depende
de la implementación iconv() del sistema (cf. ICONV_IMPL
).
Algunas implementaciones son conocidas por ignorar //TRANSLIT
,
por lo que la conversión de caracteres ilegales probablemente fallará para
to_encoding
.
string
La chaîne de caractères a convertir.
Retorna la chaîne de caractères convertida, o false
en caso de error.
Ejemplo #1 Ejemplo con 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;
?>
El resultado del ejemplo sería algo similar a:
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 '
Nota:
El encodaje de caracteres y las opciones disponibles dependen de la implementación de iconv. Si el argumento de
from_encoding
oto_encoding
no es soportado en el sistema actual,false
será retornado.