(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
Estilo orientado a objetos
Estilo procedural
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.
subtagsUm 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 servariant0,variant1, …,variant14. No ID de localidade retornado, a sub-etiqueta é ordenada pelo sufixo resultando emvariant0seguida porvariant1, seguida porvariant2e 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.
O identificador de localidade correspondente, ou false quando subtags estiver vazio.
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