array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'locale.filtermatches.php', 1 => 'Locale::filterMatches', 2 => '言語タグフィルタがロケールにマッチするかどうかを調べる', ), 'up' => array ( 0 => 'class.locale.php', 1 => 'Locale', ), 'prev' => array ( 0 => 'locale.composelocale.php', 1 => 'Locale::composeLocale', ), 'next' => array ( 0 => 'locale.getallvariants.php', 1 => 'Locale::getAllVariants', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/intl/locale/filter-matches.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Locale::filterMatches

locale_filter_matches

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

Locale::filterMatches -- locale_filter_matches — 言語タグフィルタがロケールにマッチするかどうかを調べる

説明

オブジェクト指向型

public static Locale::filterMatches(string $languageTag, string $locale, bool $canonicalize = false): ?bool

手続き型

locale_filter_matches(string $languageTag, string $locale, bool $canonicalize = false): ?bool

languageTag フィルタが locale でマッチするかどうかを RFC 4647 の基本フィルタリングアルゴリズムで調べます。

パラメータ

languageTag

調べたい言語タグ。

locale

調べる対象となる言語の範囲。

canonicalize

true の場合は、引数を正式な形式に変換してからマッチを行います。

戻り値

locale が languageTag にマッチする場合に true、 それ以外の場合に false を返します。

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

例

例1 locale_filter_matches() の例

<?php
echo (locale_filter_matches('de-DEVA','de-DE', false)) ? "Matches" : "Does not match";
echo '; ';
echo (locale_filter_matches('de-DE_1996','de-DE', false)) ? "Matches" : "Does not match";
?>

例2 オブジェクト指向の例

<?php
echo (Locale::filterMatches('de-DEVA','de-DE', false)) ? "Matches" : "Does not match";
echo '; ';
echo (Locale::filterMatches('de-DE-1996','de-DE', false)) ? "Matches" : "Does not match";
?>

上の例の出力は以下となります。

Does not match; Matches

参考