(PHP 7, PHP 8)
IntlChar::charName — 取得 Unicode 字元的名稱
$codepoint
, int $type
= IntlChar::UNICODE_CHAR_NAME): ?string取得 Unicode 字元的名稱。
根據 type
參數,返回的字元名稱會是「現代」名稱或是在 Unicode 1.0 版本中定義的名稱。名稱只包含「不變」字元,例如 A-Z、0-9、空格和 '-'。只有當 Unicode 1.0 名稱與現代名稱不同,且 ICU 包含其資料時,才會擷取 Unicode 1.0 名稱。
codepoint
整數程式碼點值 (例如,U+2603 SNOWMAN 的 0x2603
),或是編碼為 UTF-8 字串的字元 (例如 "\u{2603}"
)
type
用於查詢的命名集。可以是以下任何常數
對應的名稱,如果此字元沒有名稱,則傳回空字串;如果沒有此程式碼點,則傳回 null
。
範例 #1 測試不同的程式碼點
<?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}"));
?>
上述範例將輸出:
string(9) "FULL STOP" string(9) "FULL STOP" string(7) "SNOWMAN" string(0) ""