iconv

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

iconvConvierte una cadena de caracteres de un encodaje a otro

Descripción

iconv(string $from_encoding, string $to_encoding, string $string): string|false

Convierte la cadena string desde from_encoding hacia el encodaje to_encoding.

Parámetros

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.

Precaución

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.

Valores devueltos

Retorna la chaîne de caractères convertida, o false en caso de error.

Ejemplos

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 '

Notas

Nota:

El encodaje de caracteres y las opciones disponibles dependen de la implementación de iconv. Si el argumento de from_encoding o to_encoding no es soportado en el sistema actual, false será retornado.

Ver también