mb_internal_encoding

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

mb_internal_encoding — Define/Obtém a codificação de caracteres interna

Descrição

mb_internal_encoding(?string $encoding = null): string|bool

Define/Obtém a codificação de caracteres interna

Parâmetros

encoding

encoding é o nome da codificação de caracteres usado para a conversão de codificação de caracteres de entrada HTTP, conversão de codificação de caracteres de saída HTTP, e a codificação de caracteres padrão para funções de string definidas pelo módulo mbstring. Deve-se observar que a codificação interna é totalmente diferente da utilizada em regex multibyte.

Valor Retornado

Se encoding for definido, então Retorna true em caso de sucesso ou false em caso de falha. Nesse caso, a codificação de caracteres para regex multibyte NÃO é alterada. Se encoding for omitido, então o nome atual da codificação de caracteres é retornado.

Erros/Exceções

A partir do PHP 8.0.0, um ValueError é lançado se o valor de 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.0.0 O parâmetro encoding agora pode ser nulo.
8.0.0 Agora lança um ValueError se encoding for uma codificação inválida. Anteriormente, um E_WARNING era emitido.

Exemplos

Example #1 Exemplo de mb_internal_encoding()

<?php
/* Define a codificação de caracteres interna como UTF-8 */
mb_internal_encoding("UTF-8");

/* Exibe a codificação de caracteres interna atual */
echo mb_internal_encoding();
?>

Veja Também