Locale::parseLocale

locale_parse

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

Locale::parseLocale -- locale_parse — Retourne les sous-éléments de la locale

Description

Style orienté objet

public static function Locale::parseLocale(string $locale): ?array

Style procédural

function locale_parse(string $locale): ?array

Retourne un tableau de paires clé-valeur pour les éléments du sous-tag de la locale.

Liste de paramètres

locale: La locale dont il faut extraire le tableau. Il est à noter que 'variant' et 'private' peuvent prendre jusqu'à 15 valeurs au maximum, alors que 'extlang' peut prendre jusqu'à 3 valeurs. Si une chaîne vide est passée, la valeur retournée par locale_get_default() est utilisée à la place.

Valeurs de retour

Retourne un tableau contenant la liste des paires clé-valeur, où les clés sont les noms des éléments, et les valeurs sont leur valeur associée. Le tableau est ordonné de la même manière que les éléments dans la locale, par exemple si les variantes sont -varX-varY-varZ alors le tableau retourné contiendra variant0=>varX, variant1=>varY, variant2=>varZ.

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

Exemples

Exemple #1 Exemple avec locale_parse(), procédural

<?php
$arr = locale_parse('sl-Latn-IT-nedis');
if ($arr) {
    foreach ($arr as $key => $value) {
        echo "$key : $value , ";
    }
}
?>

Exemple #2 Exemple avec locale_parse(), POO

<?php
$arr = Locale::parseLocale('sl-Latn-IT-nedis');
if ($arr) {
    foreach ($arr as $key => $value) {
        echo "$key : $value , ";
    }
}
?>

L'exemple ci-dessus va afficher :

language : sl , script : Latn , region : IT , variant0 : NEDIS ,

Exemple #3 Une chaîne vide utilise la locale par défaut

<?php
locale_set_default('fr-Latn-FR');
$arr = locale_parse('');
if ($arr) {
    foreach ($arr as $key => $value) {
        echo "$key : $value , ";
    }
}
?>

L'exemple ci-dessus va afficher :

language : fr , script : Latn , region : FR ,

Voir aussi

locale_compose() - Retourne un identifiant de locale correct
locale_get_default() - Lit la valeur par défaut d'une locale pour la variable globale 'default_locale'
locale_set_default() - Configure la locale par défaut