言語タグフィルタがロケールにマッチするかどうかを調べる

# Locale::filterMatches

# locale_filter_matches

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

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

### 説明

オブジェクト指向型

public static Locale::filterMatches ( string `$langtag` , string `$locale` [, bool `$canonicalize` = false ] ) : bool

手続き型

locale_filter_matches ( string `$langtag` , string `$locale` [, bool `$canonicalize` = false ] ) : bool

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

### パラメータ

`langtag`

  調べたい言語タグ。

`locale`

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

`canonicalize`

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

### 返り値

$locale が $langtag にマッチする場合に `TRUE`、 それ以外の場合に `FALSE` を返します。

### 例

例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

### 参考

- locale_lookup() - その言語にマッチする言語タグの一覧を検索する