Locale::canonicalize

locale_canonicalize

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

Locale::canonicalize -- locale_canonicalizeCanonise la chaîne représentant la locale

Description

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

Canonise la chaîne représentant la locale passée au format ICU.

Ceci ne signifie pas nécessairement ou ne retourne pas une locale valide. C'est seulement une version de l'entrée qui a été canonisée selon les règles d'ICU.

Le comportement de cette fonction dépend de la version d'ICU utilisée par PHP (INTL_ICU_VERSION).

Liste de paramètres

locale
La chaîne de la locale originale

Valeurs de retour

Chaîne canonisée dans la locale.

Retourne null quand la longueur de locale excède INTL_MAX_LOCALE_LEN.

Exemples

Exemple #1 Exemple de locale_canonicalize()

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

Résultat de l'exemple ci-dessus est similaire à :

en_US
totally_NOT_VALID
add a note

User Contributed Notes 1 note

up
4
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