Locale::canonicalize

locale_canonicalize

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

Locale::canonicalize -- locale_canonicalize — Canonicalize the locale string

说明

public static Locale::canonicalize(string $locale): ?string

Canonicalizes the passed locale string to ICU format.

This does not necessarily indicate or return a valid locale. It is only a version of the input that has been canonicalized according to ICU rules.

The behavior of this function depends on the version of ICU PHP is using (INTL_ICU_VERSION).

参数

locale: Original locale string.

返回值

Canonicalized locale string.

当 locale 的长度超过 INTL_MAX_LOCALE_LEN 时返回 null。

示例

示例 #1 locale_canonicalize() example

echo Locale::canonicalize('en-US.utf8') . "\n";
echo Locale::canonicalize('totally-not-valid') . "\n";

以上示例的输出类似于：

en_US
totally_NOT_VALID

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 1 note

down

jerome at chaman dot ca ¶

9 years ago

this method performs Level 1 and Level 2 canonicalization according to ICU standards. See http://userguide.icu-project.org/locale#TOC-Canonicalization. 

echo \Locale::canonicalize ( 'en-US.utf8' ); 
// "en_U"
echo \Locale::canonicalize ( 'FR-fr@EURO' ); 
// "fr_FR@currency=EUR"
echo \Locale::canonicalize ( '' ); 
// "en_US_POSIX"