Locale::canonicalize

locale_canonicalize

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Locale::canonicalize -- locale_canonicalize — Канонизировать строку локали

Описание

public static Locale::canonicalize(string $locale): ?string

Канонизирует переданную строку локали в формат ICU.

Метод может не указывать или возвращать действительную локаль. Это лишь версия входных данных, которая была канонизирована в соответствии с правилами ICU.

Поведение метода зависит от версии ICU, используемой PHP (INTL_ICU_VERSION).

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

locale: Оригинальная строка локализации.

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

Канонизированная строка локали.

Метод возвращает null, если длина параметра locale превышает значение константы INTL_MAX_LOCALE_LEN.

Примеры

Пример #1 Пример использования функции locale_canonicalize()

echo Locale::canonicalize('en-US.utf8') . "\n";
echo Locale::canonicalize('totally-not-valid') . "\n";

Вывод приведённого примера будет похож на:

en_US
totally_NOT_VALID