IntlChar::charName
(PHP 7)
IntlChar::charName — Retrieve the name of a Unicode character
説明
public static IntlChar::charName
( mixed $codepoint
[, int $nameChoice
= IntlChar::UNICODE_CHAR_NAME
] ) : string
Retrieves the name of a Unicode character.
Depending on nameChoice
, the resulting character name is the "modern" name or the name that
was defined in Unicode version 1.0. The name contains only "invariant" characters like A-Z, 0-9, space, and '-'.
Unicode 1.0 names are only retrieved if they are different from the modern names and if ICU contains the data for them.
パラメータ
codepoint
- コードポイントを表す int 型の値 (例: U+2603 SNOWMAN を表す
0x2603
)、あるいは UTF-8 文字列としてエンコードされた文字 (例:"\u{2603}"
)。 nameChoice
- Which set of names to use for the lookup. Can be any of these constants:
IntlChar::UNICODE_CHAR_NAME
(default)IntlChar::UNICODE_10_CHAR_NAME
IntlChar::EXTENDED_CHAR_NAME
IntlChar::CHAR_NAME_ALIAS
IntlChar::CHAR_NAME_CHOICE_COUNT
返り値
The corresponding name, or an empty string if there is no name for this character,
or null
if there is no such code point.
例
例1 さまざまなコードポイントの例
<?phpvar_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) ""
参考
- IntlChar::charFromName() - Find Unicode character by name and return its code point value
- IntlChar::enumCharNames() - Enumerate all assigned Unicode characters within a range