IntlChar::charName

(PHP 7, PHP 8)

IntlChar::charName — Obtém o nome de um caractere Unicode

Descrição

public static IntlChar::charName(int|string $codepoint, int $type = IntlChar::UNICODE_CHAR_NAME): ?string

Obtém o nome de um caractere Unicode.

Dependendo do parâmetro type, o nome resultante do caractere será o nome "moderno" ou o nome que foi definido na versão 1.0 do Unicode. O nome contém apenas caracteres "invariantes" como A-Z, 0-9, espaço e '-'. Nomes do Unicode 1.0 somente são obtidos se eles fores diferentes dos nomes modernos e se a ICU contiver dados para eles.

Parâmetros

codepoint

O valor int do ponto de código (por exemplo, 0x2603 para U+2603 SNOWMAN) ou o caractere codificado como uma string UTF-8 (por exemplo, "\u{2603}").

type

Define qual o conjunto de nomes usado na pesquisa. Pode ser uma destas contantes:

Valor Retornado

O nome correspondente, ou uma string vazia se não houver nome para este caractere, ou null se não houver tal ponto de código.

Exemplos

Example #1 Testando diferentes pontos de código

<?php
var_dump(IntlChar::charName("."));
var_dump(IntlChar::charName(".", IntlChar::UNICODE_CHAR_NAME));
var_dump(IntlChar::charName("\u{2603}"));
var_dump(IntlChar::charName("\u{0000}"));
?>

O exemplo acima produzirá:

string(9) "FULL STOP"
string(9) "FULL STOP"
string(7) "SNOWMAN"
string(0) ""

Veja Também