Documentación offline PHP master

Locale::lookup

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Locale::lookup

locale_lookup

Búsqueda en la lista de la mejor lengua

Descripción#

Estilo orientado a objetos

public static Locale::lookup(array $languageTag, string $locale, [bool $canonicalize], [string $defaultLocale]): string
```php

Estilo procedimental

```php
locale_lookup(array $languageTag, string $locale, [bool $canonicalize], [string $defaultLocale]): 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 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 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

Véase también#

locale_filter_matches