PHP 8.4.2 Released!

    IntlChar::charName

    (PHP 7, PHP 8)

    IntlChar::charName — Retrieve the name of a Unicode character

    Description

    public static IntlChar::charName(int|string $codepoint, int $type = IntlChar::UNICODE_CHAR_NAME): ?string

    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

    codepoint

    The int codepoint value (e.g. 0x2603 for U+2603 SNOWMAN), or the character encoded as a UTF-8 string (e.g. "\u{2603}")

    type

    Which set of names to use for the lookup. Can be any of these constants:

    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 #1 Testing different code points

    <?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:

    string(9) "FULL STOP"
string(9) "FULL STOP"
string(7) "SNOWMAN"
string(0) ""

    See Also

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top