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

mb_convert_encoding

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

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

Descrição

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

Converte string de from_encoding, ou a codificação interna atual, para to_encoding. Se string for um array, todos os seus valores string serão convertidos recursivamente.

Parâmetros

string

A string ou array a ser convertida.

to_encoding

A codificação desejada para o resultado.

from_encoding

A codificação atual usada para interpretar string. Múltiplas codificações podem ser especificadas como um array ou uma lista separada por vírgulas, nesse caso, a codificação correta será detectada usando o mesmo algoritmo que mb_detect_encoding().

Se from_encoding for omitida ou null, a configuração mbstring.internal_encoding será usada se definida, caso contrário, a configuração default_charset.

Consulte codificações suportadas para os valores válidos de to_encoding e from_encoding.

Valor Retornado

A string ou array codificada em caso de sucesso, ou false em caso de falha.

Erros/Exceções

A partir do PHP 8.0.0, um ValueError é lançado se o valor de to_encoding ou from_encoding for uma codificação inválida. Antes do PHP 8.0.0, um E_WARNING era emitido.

Registro de Alterações

Versão Descrição
8.2.0 mb_convert_encoding() não retornará mais as seguintes codificações não textuais: "Base64", "QPrint", "UUencode", "HTML entities", "7 bit" e "8 bit".
8.0.0 mb_convert_encoding() agora lançará um ValueError quando to_encoding receber uma codificação inválida.
8.0.0 mb_convert_encoding() agora lançará um ValueError quando from_encoding receber uma codificação inválida.
8.0.0 from_encoding agora é anulável.
7.2.0 Esta função agora aceita um array como string. Anteriormente, apenas strings eram suportadas.

Exemplos

Exemplo #1 Exemplo de mb_convert_encoding()

<?php
/* Converte a codificação interna para SJIS */
$str = mb_convert_encoding($str, "SJIS");

/* Converte EUC-JP para UTF-7 */
$str = mb_convert_encoding($str, "UTF-7", "EUC-JP");

/* Detecta automaticamente a codificação a partir de JIS, eucjp-win, sjis-win, e converte str para UCS-2LE */
$str = mb_convert_encoding($str, "UCS-2LE", "JIS, eucjp-win, sjis-win");

/* Se mbstring.language for "Japanese", "auto" é expandido para "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
$str = mb_convert_encoding($str, "EUC-JP", "auto");
?>

Veja Também