mb_chr

(PHP 7 >= 7.2.0, PHP 8)

mb_chrRetorna um caractere pelo valor do ponto de código Unicode

Descrição

mb_chr(int $codepoint, ?string $encoding = null): string|false

Retorna uma string contendo o caractere especificado pelo valor do ponto de código Unicode, codificado na codificação especificada.

Esta função complementa mb_ord().

Parâmetros

codepoint

Um valor de ponto de código Unicode, por exemplo, 128024 para U+1F418 ELEPHANT

encoding

O parâmetro encoding é a codificação de caracteres. Se for omitido ou null, o valor da codificação de caracteres interna será usado.

Valor Retornado

Uma string contendo o caractere solicitado, se puder ser representado na codificação especificada ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro encoding agora pode ser nulo.

Exemplos

Example #1 Testando diferentes pontos de código

<?php
$values = [65, 63, 0x20AC, 128024];
foreach ($values as $value) {
    var_dump(mb_chr($value, 'UTF-8'));
    var_dump(mb_chr($value, 'ISO-8859-1'));
}
?>

O exemplo acima produzirá:

string(1) "A"
string(1) "A"
string(1) "?"
string(1) "?"
string(3) "€"
bool(false)
string(4) "🐘"
bool(false)

Veja Também

  • mb_internal_encoding() - Define/Obtém a codificação de caracteres interna
  • mb_ord() - Obtém o ponto de código Unicode do caractere
  • IntlChar::ord() - Retorna o valor do ponto de código Unicode do caractere
  • chr() - Gera uma string de um byte a partir de um número