php8.5
Home/ Manual/ intl / locale/ Locale::filterMatches

Locale::filterMatches

PHP function Edit on GitHub ✎

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

Checks if a language tag filter matches with locale

Description

Oop

Locale::filterMatches(string $languageTag, string $locale, bool $canonicalize = false): bool|null

Procedural

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

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

Parameters

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.

Return Values

true if locale matches languageTag false otherwise.

Return

Examples

locale_filter_matches() example

php
<?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";
?>

OO example

php
<?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";
?>

The above example will output:

output
Does not match; Matches

See Also

Source: reference/intl/locale/filter-matches.xml · from the official PHP manual (php/doc-en)