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
Добавить

Примечания пользователей 1 note

up
3
jerome at chaman dot ca
10 years ago
this method performs Level 1 and Level 2 canonicalization according to ICU standards. See http://userguide.icu-project.org/locale#TOC-Canonicalization. 

echo \Locale::canonicalize ( 'en-US.utf8' ); 
// "en_U"
echo \Locale::canonicalize ( 'FR-fr@EURO' ); 
// "fr_FR@currency=EUR"
echo \Locale::canonicalize ( '' ); 
// "en_US_POSIX"
To Top