IntlChar::charName

Retrieve the name of a Unicode character

&reftitle.description; public static ``string``null```IntlChar::charName` ``int``string```codepoint` `int` `type` IntlChar::UNICODE_CHAR_NAME

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.

&reftitle.parameters;

`codepoint`

- &intl.codepoint.parameter;

`type`

- 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`
&reftitle.returnvalues;

The corresponding name, or an empty string if there is no name for this character, or &null; if there is no such code point.

&reftitle.examples;

### &intl.codepoint.example;

    <?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}"));
    ?>

&example.outputs;

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

&reftitle.seealso;

- `IntlChar::charFromName`
- `IntlChar::enumCharNames`