Pesquisa a lista de etiquetas de língua pela melhor correspondência à língua

# Locale::lookup

# locale_lookup

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

Locale::lookup -- locale_lookup — Pesquisa a lista de etiquetas de língua pela melhor correspondência à língua

### Descrição

Estilo orientado a objetos

public static function Locale::lookup(
array `$languageTag`,
string `$locale`,
bool `$canonicalize` = `false`,
?string `$defaultLocale` = `null`
): ?string

Estilo procedural

function locale_lookup(
array `$languageTag`,
string `$locale`,
bool `$canonicalize` = `false`,
?string `$defaultLocale` = `null`
): ?string

Pesquisa os itens em `languageTag` pela melhor correspondência ao intervalo de línguas especificado em `locale` de acordo com o algoritmo de procura da RFC 4647.

### Parâmetros

`languageTag`

  Um array contendo uma lista de etiquetas de língua para comparar a `locale`. Máximo de 100 itens permitidos.

`locale`

  A localidade a ser usada como faixa de línguas na pesquisa.

`canonicalize`

  Se verdedeiro, os argumentos serão convertidos para a forma canônica antes de se fazer a correspondência.

`defaultLocale`

  A localidade a ser usada se nenhuma correspondência for encontrada.

### Valor Retornado

A etiqueta de língua que melhor corresponder ou o valor padrão.

Retorna `null` quando o comprimento de `locale` excede `INTL_MAX_LOCALE_LEN`.

### Registro de Alterações

Versão | Descrição
--- | ---
7.4.0 | `defaultLocale` agora pode ser nulo.

### Exemplos

Exemplo #1 Exemplo de locale_lookup()

    <?php
    $arr = array(
        'de-DEVA',
        'de-DE-1996',
        'de',
        'de-De'
    );
    echo locale_lookup($arr, 'de-DE-1996-x-prv1-prv2', true, 'en_US');
    ?>

Exemplo #2 Exemplo OO

    <?php
    $arr = array(
        'de-DEVA',
        'de-DE-1996',
        'de',
        'de-De'
    );
    echo Locale::lookup($arr, 'de-DE-1996-x-prv1-prv2', true, 'en_US');
    ?>

O exemplo acima produzirá:

    de_de_1996

### Veja Também

- locale_filter_matches() - Verifica se um filtro de etiqueta de língua corresponde à localidade

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open