Búsqueda en la lista de la mejor lengua

# Locale::lookup

# locale_lookup

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

Locale::lookup -- locale_lookup — Búsqueda en la lista de la mejor lengua

### Descripción

Estilo orientado a objetos

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

Estilo procedimental

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

Búsqueda en la lista `languageTag` de la mejor lengua, para la configuración local especificada por `locale`, según el algoritmo de la RFC 4647.

### Parámetros

`languageTag`

  Un array que contiene una lista de lenguas a comparar con la configuración local `locale`. Se permite un máximo de 100 elementos.

`locale`

  La configuración local a utilizar para realizar la búsqueda.

`canonicalize`

  Si `true` los argumentos serán convertidos a su forma canónica antes de su búsqueda.

`defaultLocale`

  La configuración local a utilizar si no se encuentra ninguna solución.

### Valores devueltos

La lengua más cercana que haya sido encontrada en la lista, o bien el valor por defecto.

Devuelve `null` cuando la longitud de `locale` excede `INTL_MAX_LOCALE_LEN`.

### Historial de cambios

Versión | Descripción
--- | ---
7.4.0 | `defaultLocale` ahora es nullable.

### Ejemplos

Ejemplo #1 Ejemplo con locale_lookup(), procedimental

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

Ejemplo #2 Ejemplo con Locale::lookup(), POO

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

El ejemplo anterior mostrará:

    de_de_1996

### Ver también

- locale_filter_matches() - Verifica si el tag de idioma coincide con una configuración local

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