If `$locale` is invalid, the return value is actually the value of `$locale`, not `NULL` or `FALSE` as you might expect.
(If `$in_locale` is invalid, but `$locale` is valid, the return value is the language name in the default locale.)
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Locale::getDisplayLanguage -- locale_get_display_language — Returns an appropriately localized display name for language of the inputlocale
Object-oriented style
$locale
, ?string $displayLocale
= null
): string|falseProcedural style
Returns an appropriately localized display name for language of the input
locale. If is null
then the default locale is used.
locale
The locale to return a display language for
displayLocale
Optional format locale to use to display the language name
Display name of the language for the locale
in the format appropriate for
displayLocale
, or false
on failure.
Version | Description |
---|---|
8.0.0 |
displayLocale is nullable now.
|
Example #1 locale_get_display_language() example
<?php
echo locale_get_display_language('sl-Latn-IT-nedis', 'en');
echo ";\n";
echo locale_get_display_language('sl-Latn-IT-nedis', 'fr');
echo ";\n";
echo locale_get_display_language('sl-Latn-IT-nedis', 'de');
?>
Example #2 OO example
<?php
echo Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'en');
echo ";\n";
echo Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'fr');
echo ";\n";
echo Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'de');
?>
The above example will output:
Slovenian; slov\xc3\xa8ne; Slowenisch
If `$locale` is invalid, the return value is actually the value of `$locale`, not `NULL` or `FALSE` as you might expect.
(If `$in_locale` is invalid, but `$locale` is valid, the return value is the language name in the default locale.)