Locale::composeLocale

locale_compose

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

Locale::composeLocale -- locale_compose — Retorna ID de localidade corretamente ordenado e delimitado

Descrição

Estilo orientado a objetos

public static Locale::composeLocale(array $subtags): string|false

Estilo procedural

locale_compose(array $subtags): string|false

Retorna um ID de localidade corretamente ordenado e delimitado. As chaves identificam as sub-etiquetas de ID da localidade em particular, e os valores são associados às sub-etiquetas.

Parâmetros

subtags

Um array contendo uma lista de pares de chave-valor, onde as chaves identificam as sub-etiquetas de ID da localidade em particular, e os valores são os associados às sub-etiquetas.

Nota:
As sub-etiquetas 'variant' e 'private' suportam no máximo 15 valores enquanto que 'extlang' suporta no máximo 3. Por exemplo, variantes são permitiras com sufixo no intervalo 0-14. Por isso as chaver para o array de entrada podem ser variant0, variant1, …,variant14. No ID de localidade retornado, a sub-etiqueta é ordenada pelo sufixo resultando em variant0 seguida por variant1, seguida por variant2 e assim por diante.

Alternativamente, os valores de 'variant', 'private' e 'extlang' podem ser especificados como array sob chave específica (ex.: 'variant'). Neste caso não se aplica limite ao número de sub-etiquetas reconhecidas.

Valor Retornado

O identificador de localidade correspondente, ou false quando subtags estiver vazio.

Exemplos

Exemplo #1 Exemplo de locale_compose()

<?php
$arr = array(
    'language'=>'en',
    'script'  =>'Hans',
    'region'  =>'CN',
    'variant2'=>'rozaj',
    'variant1'=>'nedis',
    'private1'=>'prv1',
    'private2'=>'prv2',
);
echo locale_compose($arr);
?>

Exemplo #2 Exemplo OO

<?php
$arr = array(
    'language'=>'en' ,
    'script'  =>'Hans',
    'region'  =>'CN',
    'variant2'=>'rozaj',
    'variant1'=>'nedis',
    'private1'=>'prv1',
    'private2'=>'prv2',
);
echo Locale::composeLocale($arr);
?>

O exemplo acima produzirá:

Locale: en_Hans_CN_nedis_rozaj_x_prv1_prv2

Exemplo #3 Limites de sub-etiquetas

Se subtags são fornecidas como chaves separadas com sufixo numérico, chaves não suportadas são silenciosamente ignoradas (neste caso 'extlang3'), e ordenadas no resultado pelo sufixo numérico. Não é limites se as sub-etiquetas são informadas como array; a ordem é conforme informada.

<?php
$arr = array(
    'language' => 'en',
    'script'   => 'Hans',
    'region'   => 'CN',
    'extlang3' => 'd',
    'extlang2' => 'c',
    'extlang1' => 'b',
    'extlang0' => 'a',
);
echo locale_compose($arr), PHP_EOL;

$arr = array(
    'language' => 'en',
    'script'   => 'Hans',
    'region'   => 'CN',
    'extlang'  => ['a', 'b', 'c', 'd'],
);
echo locale_compose($arr), PHP_EOL;
?>

O exemplo acima produzirá:

en_a_b_c_Hans_CN
en_a_b_c_d_Hans_CN

Veja Também

locale_parse() - Retorna um array de chaves-valores de elementos de sub-etiquetas de ID de localidade