Locale::canonicalize

locale_canonicalize

ロケール文字列を正規化する

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

渡されたロケール文字列を、ICU フォーマットに正規化します。

この関数は有効なロケールを示す、または返すとは限りません。単に、ICU の規則に従って正規化された入力のバージョンに過ぎません。

この関数の振る舞いは、 PHP が使っている ICU のバージョン (INTL_ICU_VERSION) に依存します。

正規化されたロケール文字列を返します。

locale の長さが INTL_MAX_LOCALE_LEN を超えた場合、null を返します。

例1 locale_canonicalize の例

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

上の例の出力は、たとえば以下のようになります。

en_US
totally_NOT_VALID