Locale::getScript
Locale::parseLocale
Locale
PHP Manual

# Locale::lookup

# locale_lookup

(No version information available, might be only in CVS)

locale_lookup — Searches the language tag list for the best match to the language

### Description

Object oriented style

static string Locale::lookup ( array `$langtag` , string `$locale` , string `$default` )

Procedural style

string locale_lookup ( array `$langtag` , string `$locale` , string `$default` )

Searches the items in `langtag` for the best match to the language range specified in `locale` according to RFC 4647's lookup algorithm.

### Parameters

`langtag`

  An array containing a list of language tags to compare to `locale` . Maximum 100 items allowed.

`locale`

  The locale to use as the language range when matching.

`default`

  The locale to use if no match is found.

### Return Values

The closest matching language tag or default value.

### Examples

Example#1 locale_lookup() example

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

Example#2 OO example

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

The above example will output:

    de_de_1996

### See Also

- locale_filter_matches()

Locale::getScript
Locale::parseLocale
Locale
PHP Manual