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

Exemplo #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

mb_http_input() - Detecta a codificação de caracteres de entrada HTTP
mb_http_output() - Define/Obtém a codificação de caracteres de saída HTTP
mb_detect_order() - Define ou obtém a ordem de detecção de codificação de caracteres
mb_regex_encoding() - Define/Obtém codificação de caracteres para regex multibyte