IntlChar::charName

(PHP 7, PHP 8)

IntlChar::charName — Получить имя символа Unicode

Описание

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

Возвращает имя символа Unicode.

В зависимости от type, возвращённое имя может быть как "современным", так и именем определённым в Unicode версии 1.0. Имя содержит только "неизменяемые" символы, такие как A-Z, 0-9, пробел и '-'. Имя Unicode 1.0 возвращается только если оно отличается от "современного" для данного символа и если в ICU есть запись о нем.

Список параметров

codepoint

Целочисленное (int) задание кода символа (например 0x2603 для U+2603 СНЕГОВИКА), или символ закодированный строку UTF-8 (например "\u{2603}")

type

Какие типы символов искать. Одна из констант:

  • IntlChar::UNICODE_CHAR_NAME (default)
  • IntlChar::UNICODE_10_CHAR_NAME
  • IntlChar::EXTENDED_CHAR_NAME
  • IntlChar::CHAR_NAME_ALIAS
  • IntlChar::CHAR_NAME_CHOICE_COUNT

Возвращаемые значения

Соответствующее имя или пустую строку, если символ не имеет имени, либо null, если такого символа нет.

Примеры

Пример #1 Тестирование различных способов задания

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

Результат выполнения данного примера:

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

Смотрите также

  • IntlChar::charFromName() - Найти символ Unicode по его имени и вернуть его код
  • IntlChar::enumCharNames() - Перечисляет все присвоенные символы Unicode в заданном диапазоне