Checks if a language tag filter matches with locale

# Locale::filterMatches

# locale_filter_matches

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

Locale::filterMatches -- locale_filter_matches — Checks if a language tag filter matches with locale

### 说明

面向对象风格

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

过程化风格

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

Checks if a `languageTag` filter matches with `locale` according to RFC 4647's basic filtering algorithm

### 参数

`languageTag`

  The language tag to check

`locale`

  The language range to check against

`canonicalize`

  If true, the arguments will be converted to canonical form before matching.

### 返回值

`true` if `locale` matches `languageTag` `false` otherwise.

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

### 示例

示例 #1 locale_filter_matches() example

    <?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 OO example

    <?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() - Searches the language tag list for the best match to the language

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open