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 — Retourne un nom approprié pour l'affichage d'un nom de langue

Description

Style orienté objet

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

Style procédural

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

Retourne un nom approprié pour l'affichage d'un nom de langue. Si la valeur null est passée en argument, la locale par défaut est utilisée.

Liste de paramètres

locale: La locale dont il faut retourner le nom de langue
displayLocale: Un format optionnel pour l'affichage du nom de langue.

Valeurs de retour

Le nom de la langue à afficher pour la locale, dans le format défini par displayLocale, ou false si une erreur survient.

Historique

Version	Description
8.0.0	`displayLocale` est désormais nullable.

Exemples

Exemple #1 Exemple avec locale_get_display_language(), procédural

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

Exemple #2 Exemple avec locale_get_display_language(), POO

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

L'exemple ci-dessus va afficher :

Slovenian;
slov\xc3\xa8ne;
Slowenisch

Voir aussi

locale_get_display_name() - Retourne un nom d'affichage correct pour une locale
locale_get_display_script() - Retourne le nom du script de la locale
locale_get_display_region() - Retourne un nom pour la région de la locale
locale_get_display_variant() - Retourne un nom pour la variante de la 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