PHP IntlChar getPropertyValueName()用法及代碼示例

IntlChar::getPropertyValueName() 函數是 PHP 中的一個內置函數，用於獲取屬性值的 Unicode 名稱。它將根據 PropertyValueAliases.txt 中存在的數據，這是 Unicode 數據庫文件。

用法:

string IntlChar::getPropertyValueName( $property, $value, 
$nameChoice = IntlChar::LONG_PROPERTY_NAME )

參數：此函數接受上述和以下描述的三個參數：

• property:它用於基於 Unicode 屬性的查找任務。它與 IntlChar::PROPERTY_* 常量非常相似。如果超出範圍，或者該方法與給定值不兼容，則將返回 False。
• value:對於給定的屬性，它將是一個選擇器。如果超出範圍，或者該方法與給定值不兼容，則將返回 False。值的範圍是從 0 到最大值。除此之外，還會有一些例外。他們是：
  • IntlChar::PROPERTY_CANONICAL_COMBINING_CLASS值根本不連續。此外，範圍將從 0 到 240。
  • IntlChar::PROPERTY_BLOCK值從非零值 IntlChar::BLOCK_CODE_BASIC_LATIN 開始。
• nameChoice:要查看要獲取哪些名稱，它將是一個選擇器。如果超出範圍，或者該方法與給定值不兼容，則將返回 False。大多數情況下，所有值都是long值。有些可能有短名稱，但有些則沒有。對於其他名稱，Unicode 將允許。如果存在，它們將通過將 1、2、3 等添加到 IntlChar::LONG_PROPERTY_NAME 來返回。

返回值：如果 nameChoice 或屬性完全超出範圍，則將返回 False。否則，名稱將被返回。如果將給出 nameChoice，則返回 False。如果 IntlChar::SHORT_PROPERTY_NAME 返回 False，則 IntlChar::LONG_PROPERTY_NAME(及更高版本)可能仍返回非 False 值。

程序：

<?php
  
// PHP program to uses IntlChar::getPropertyValueName()
// function
  
var_dump(IntlChar::getPropertyValueName
   (IntlChar::PROPERTY_INT_START, IntlChar::BLOCK_CODE_TELUGU));
  
var_dump(IntlChar::getPropertyValueName
                (IntlChar::PROPERTY_GENERAL_CATEGORY, IntlChar::
     BLOCK_CODE_IPA_EXTENSIONS, IntlChar::SHORT_PROPERTY_NAME));
  
var_dump(IntlChar::getPropertyValueName
                      (IntlChar::PROPERTY_LINE_BREAK, IntlChar::
            BLOCK_CODE_DINGBATS, IntlChar::LONG_PROPERTY_NAME));
  
var_dump(IntlChar::getPropertyValueName
                    (IntlChar::PROPERTY_BINARY_LIMIT, IntlChar::
           BLOCK_CODE_BAMUM, IntlChar::LONG_PROPERTY_NAME + 1));
  
?>

輸出：

string(21) "Right_To_Left_Isolate"
string(2) "Lo"
bool(false)
bool(false)

參考： https://www.php.net/manual/en/intlchar.getpropertyvaluename.php