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

Beschreibung

Objektorientierter Stil

public static Locale::getDisplayLanguage(string $locale, ?string $displayLocale = null): string|false

Prozeduraler Stil

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.

Parameter-Liste

locale: The locale to return a display language for
displayLocale: Optional format locale to use to display the language name

Rückgabewerte

Display name of the language for the locale in the format appropriate for displayLocale, Bei einem Fehler wird false zurückgegeben..

Changelog

Version	Beschreibung
8.0.0	`displayLocale` is nullable now.

Beispiele

Beispiel #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');
?>

Beispiel #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');
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Slovenian;
slov\xc3\xa8ne;
Slowenisch

Siehe auch

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

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