Locale::lookup
locale_lookup
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Locale::lookup -- locale_lookup — Searches the language tag list for the best match to the language
说明
面向对象风格
array
$languageTag,string
$locale,bool
$canonicalize = false,?string
$defaultLocale = null): ?string
过程化风格
array
$languageTag,string
$locale,bool
$canonicalize = false,?string
$defaultLocale = null): ?string
Searches the items in languageTag for the best match to
the language range specified in locale according to
RFC 4647's lookup algorithm.
参数
-
languageTag -
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.
-
canonicalize -
If true, the arguments will be converted to canonical form before matching.
-
defaultLocale -
The locale to use if no match is found.
返回值
The closest matching language tag or default value.
当 locale 的长度超过 INTL_MAX_LOCALE_LEN 时返回 null。
更新日志
| 版本 | 说明 |
|---|---|
| 7.4.0 |
defaultLocale is nullable now.
|
范例
示例 #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', true, 'en_US');
?>
示例 #2 OO example
<?php
$arr = array(
'de-DEVA',
'de-DE-1996',
'de',
'de-De'
);
echo Locale::lookup($arr, 'de-DE-1996-x-prv1-prv2', true, 'en_US');
?>
以上例程会输出：
de_de_1996
add a note
User Contributed Notes 2 notes
It worth to note that if $langtag array is empty this function returns empty string and not $default . Use array(false) if your $langtag array is empty in order to get default locale.
Note that this method does not understand "similar" languages, so the following:
Locale::lookup(["en-US"], "en-GB", false);
Or:
Locale::lookup(["es-ES"], "es-CO", false);
Does not work as you would expect (empty result). To get a match in those cases you will have to use two letter language codes instead:
Locale::lookup(["en"], "en-GB", false);
Or:
Locale::lookup(["es"], "es-CO", false);
These do return 'en' and 'es' respectively.