Канонизировать строку локали

# Locale::canonicalize

# locale_canonicalize

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

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

### Описание

public static function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open