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:

IntlChar::UNICODE_CHAR_NAME (padrão)
IntlChar::UNICODE_10_CHAR_NAME
IntlChar::EXTENDED_CHAR_NAME
IntlChar::CHAR_NAME_ALIAS
IntlChar::CHAR_NAME_CHOICE_COUNT

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

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

IntlChar::charFromName() - Encontra um caractere Unicode pelo nome e retorna seu valor de ponto de código
IntlChar::enumCharNames() - Enumera todos os caracteres Unicode atribuídos dentro de um intervalo

add a note

User Contributed Notes

There are no user contributed notes for this page.