Edit Report a Bug

    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

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top