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 $displayLocale = null): string|false

Procedural style

locale_get_display_language(string $locale, ?string $displayLocale = null): string|false

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
displayLocale: 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 displayLocale, or false on failure.

Changelog

Version	Description
8.0.0	`displayLocale` is nullable now.

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

User Contributed Notes 2 notes

down

jake at qzdesign dot co dot uk ¶

5 years ago


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.)

down

-5

heitor dot siller at gmail dot com ¶

13 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'));

?>

add a note