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.)
Locale::getDisplayLanguage
locale_get_display_language
(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
Description
Object oriented style
public
static
Locale::getDisplayLanguage(string
$locale, string $in_locale = ?): stringProcedural style
locale_get_display_language(string
$locale, string $in_locale = ?): string
Returns an appropriately localized display name for language of the input
locale. If is null then the default locale is used.
Parameters
-
locale -
The locale to return a display language for
-
in_locale -
Optional format locale to use to display the language name
Return Values
display name of the language for the $locale in the format appropriate for $in_locale.
Examples
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
See Also
- locale_get_display_name() - Returns an appropriately localized display name for the input locale
- locale_get_display_script() - Returns an appropriately localized display name for script of the input locale
- locale_get_display_region() - Returns an appropriately localized display name for region of the input locale
- locale_get_display_variant() - Returns an appropriately localized display name for variants of the input locale
add a note
User Contributed Notes 2 notes
jake at qzdesign dot co dot uk ¶
4 years ago
heitor dot siller at gmail dot com ¶
12 years ago
To display special characters correctly in a web browser, it's a good idea to decode the result data with utf8_decode:
<?php
echo utf8_decode(Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'fr'));
echo utf8_decode(Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'pt-BR'));
?>
