PHP
Internationalization

IntlChar::charFromName

IntlChar::charFromName

(PHP 7)

IntlChar::charFromName — Find Unicode character by name and return its code point value

Description

public static int IntlChar::charFromName ( string $characterName [, int $nameChoice = IntlChar::UNICODE_CHAR_NAME ] )

Finds a Unicode character by its name and returns its code point value.

The name is matched exactly and completely. If the name does not correspond to a code point, FALSE is returned.

A Unicode 1.0 name is matched only if it differs from the modern name. Unicode names are all uppercase. Extended names are lowercase followed by an uppercase hexadecimal number, and within angle brackets.

Parameters

characterName

Full name of the Unicode character.

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

Return Values

The Unicode value of the code point with the given name (as an integer), or FALSE if there is no such code point.

Examples

Example #1 Testing different code points

<?php var_dump(IntlChar::charFromName("LATIN CAPITAL LETTER A") var_dump(IntlChar::charFromName("SNOWMAN") var_dump(IntlChar::charFromName("RECYCLING SYMBOL FOR TYPE-1 PLASTICS") var_dump(IntlChar::charFromName("A RANDOM STRING WHICH DOESN'T CORRESPOND TO ANY UNICODE CHARACTER") ?>

The above example will output:

int(65) int(9731) int(9843) bool(false)

See Also

  • IntlChar::charName() - Retrieve the name of a Unicode character

  • IntlChar::enumCharNames() - Enumerate all assigned Unicode characters within a range

← IntlChar::charDirection

IntlChar::charMirror →

© 1997–2017 The PHP Documentation Group

Licensed under the Creative Commons Attribution License v3.0 or later.

https://secure.php.net/manual/en/intlchar.charfromname.php