IntlChar::getPropertyName

(PHP 7, PHP 8)

IntlChar::getPropertyName — Obtém o nome Unicode de uma propriedade

Descrição

public static IntlChar::getPropertyName(int $property, int $type = IntlChar::LONG_PROPERTY_NAME): string|false

Returns o nome Unicode de uma propriedade fornecida, como especificado no arquivo de banco de dados PropertyAliases.txt.

Além disso, esta função mapeia a propriedade IntlChar::PROPERTY_GENERAL_CATEGORY_MASK para os nomes sintéticos "gcm" / "General_Category_Mask". Estes nomes não estão no arquivo PropertyAliases.txt.

Esta função é complementar à IntlChar::getPropertyEnum().

Parâmetros

property

A propriedade Unicode a ser pesquisada (consulte as constantes IntlChar::PROPERTY_*).

IntlChar::PROPERTY_INVALID_CODE não deve ser usada. Além disso, se property estiver fora do intervalo, false é retornado.

type

Selector para o nome que deve ser obtido. Se for do intervalo, false é retornado.

Todas as propriedades têm um nome longo. A maioria tem um nome curto, mas algumas não têm. Unicode permite nomes adicionais; caso presentes, estes serão retornados adicionando-se 1, 2, etc. a IntlChar::LONG_PROPERTY_NAME.

Valor Retornado

Retorna o nome, ou false se property ou type estiverem fora de seus intervalos.

Se um type retornar false, todos os valores maiores de type retornarão false, com uma exceção: se false for retornado para IntlChar::SHORT_PROPERTY_NAME, então IntlChar::LONG_PROPERTY_NAME (e maiores) podem ainda retornar valores não-false.

Exemplos

Example #1 Testando diferentes propriedades

<?php
var_dump(IntlChar::getPropertyName(IntlChar::PROPERTY_BIDI_CLASS));
var_dump(IntlChar::getPropertyName(IntlChar::PROPERTY_BIDI_CLASS, IntlChar::SHORT_PROPERTY_NAME));
var_dump(IntlChar::getPropertyName(IntlChar::PROPERTY_BIDI_CLASS, IntlChar::LONG_PROPERTY_NAME));
var_dump(IntlChar::getPropertyName(IntlChar::PROPERTY_BIDI_CLASS, IntlChar::LONG_PROPERTY_NAME + 1));
?>

O exemplo acima produzirá:

string(10) "Bidi_Class"
string(2) "bc"
string(10) "Bidi_Class"
bool(false)

Veja Também