Locale::canonicalize

locale_canonicalize

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

Locale::canonicalize -- locale_canonicalize — Canoniza a string de localidade

Descrição

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

Canonicaliza a string de localidade informada para o formato ICU.

Isso não indica ou retorna necessariamente uma localidade válida. É apenas uma versão da entrada que foi canonicalizada de acordo com as regras da ICU.

O comportamento desta função depende da versão do ICU que o PHP está utilizando (INTL_ICU_VERSION).

Parâmetros

locale: String de localidade original.

Valor Retornado

A string de localidade canonizada.

Retorna null quando o comprimento de locale excede INTL_MAX_LOCALE_LEN.

Exemplos

Exemplo #1 Exemplo de locale_canonicalize()

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

O exemplo acima produzirá algo semelhante a:

en_US
totally_NOT_VALID