CakeFest 2024: The Official CakePHP Conference

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_languageReturns 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

add a note

User Contributed Notes 2 notes

up
1
jake at qzdesign dot co dot uk
4 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.)
up
-10
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'));

?>
To Top