(PHP 7, PHP 8)
IntlChar::getPropertyName — 取得屬性的 Unicode 名稱
$property
, int $type
= IntlChar::LONG_PROPERTY_NAME): string|false傳回指定屬性的 Unicode 名稱,如同 Unicode 資料庫檔案 PropertyAliases.txt 中所提供的名稱。
此外,此函式將屬性 IntlChar::PROPERTY_GENERAL_CATEGORY_MASK
映射到合成名稱 "gcm" / "General_Category_Mask"。這些名稱不在 PropertyAliases.txt 中。
此函式是 IntlChar::getPropertyEnum() 的補充。
屬性 (property)
要查詢的 Unicode 屬性(請參閱 IntlChar::PROPERTY_*
常數)。
不應使用 IntlChar::PROPERTY_INVALID_CODE
。此外,如果 property
超出範圍,則會傳回 false
。
類型 (type)
要獲取哪個名稱的選擇器。如果超出範圍,則會傳回 false
。
所有屬性都有長名稱。大多數屬性都有簡稱,但有些沒有。Unicode 允許額外的名稱;如果存在,則可以透過將 1、2 等添加到 IntlChar::LONG_PROPERTY_NAME
來傳回這些名稱。
傳回名稱,如果 property
或 type
超出範圍,則傳回 false
。
如果給定的 type
傳回 false
,則所有較大的 type
值都將傳回 false
,但有一個例外:如果 IntlChar::SHORT_PROPERTY_NAME
傳回 false
,則 IntlChar::LONG_PROPERTY_NAME
(及更高)可能仍然傳回非 false
的值。
範例 #1 測試不同的屬性
<?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));
?>
以上範例將輸出:
string(10) "Bidi_Class" string(2) "bc" string(10) "Bidi_Class" bool(false)