IntlChar::charName
PHP function
Edit on GitHub ✎
(PHP 7, PHP 8)
Retrieve the name of a Unicode character
Description
IntlChar::charName(int|string $codepoint, int $type = IntlChar::UNICODE_CHAR_NAME): string|null
Retrieves the name of a Unicode character.
Depending on type, 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.
Parameters
codepointParameter
typeWhich set of names to use for the lookup. Can be any of these constants:
IntlChar::UNICODE_CHAR_NAME(default)IntlChar::UNICODE_10_CHAR_NAMEIntlChar::EXTENDED_CHAR_NAMEIntlChar::CHAR_NAME_ALIASIntlChar::CHAR_NAME_CHOICE_COUNT
Return Values
The corresponding name, or an empty string if there is no name for this character, or null if there is no such code point.
Examples
Example
php
<?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}"));
?>The above example will output:
output
string(9) "FULL STOP"
string(9) "FULL STOP"
string(7) "SNOWMAN"
string(0) ""