array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.iconv.php', 1 => 'iconv', 2 => 'Converte uma string de uma codificação de caracteres para outra', ), 'up' => array ( 0 => 'ref.iconv.php', 1 => 'iconv Funções', ), 'prev' => array ( 0 => 'ref.iconv.php', 1 => 'iconv Funções', ), 'next' => array ( 0 => 'function.iconv-get-encoding.php', 1 => 'iconv_get_encoding', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/iconv/functions/iconv.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

iconv

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

iconv — Converte uma string de uma codificação de caracteres para outra

Descrição

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

Converte string de from_encoding para to_encoding.

Parâmetros

from_encoding

A codificação atual usada para interpretar string.

to_encoding

A codificação desejada do resultado.

Se a string //TRANSLIT for anexada a to_encoding, a transliteração será ativada. Isso significa que, quando um caractere não pode ser representado no conjunto de caracteres de destino, ele pode ser aproximado por meio de um ou vários caracteres de aparência semelhante. Se a string //IGNORE for anexada, os caracteres que não podem ser representados no charset de destino são descartados silenciosamente. Caso contrário, E_NOTICE é gerado e a função retornará false.

Cuidado

Como //TRANSLIT funciona exatamente depende da implementação do iconv() do sistema (cf. ICONV_IMPL). Algumas implementações são conhecidas por ignorar //TRANSLIT, então a conversão provavelmente falhará para caracteres que são ilegais para to_encoding.

string

A string a ser convertida

Valor Retornado

Retorna a string convertida, ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo iconv()

<?php
$text = "Este é o símbolo do 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 'Plain : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;

?>

O exemplo acima produzirá algo semelhante a:

Original : Este é o símbolo do Euro '€'.
TRANSLIT : Este é o símbolo do Euro 'EUR'.
IGNORE   : Este é o símbolo do Euro ''.
Plain    :
Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7

Notas

Nota:

As codificações de caracteres e as opções disponíveis dependem da implementação instalada do iconv. Se o argumento para from_encoding ou to_encoding não for suportado no sistema atual, false será retornado.

Veja Também