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 — Retorna um nome apropriadamente localizado para a língua da localidade

Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Retorna um nome apropriadamente localizado para a língua da localidade. Se a localidade de entrada for null, a localidade padrão será usada.

Parâmetros

locale: A localidade para a qual será mostrada a língua
displayLocale: Formato de localidade, opcional, para mostrar o nome da língua

Valor Retornado

Nome da língua para a localidade locale no formato apropriado para displayLocale, ou false em caso de falha.

Registro de Alterações

Versão	Descrição
8.0.0	`displayLocale` agora pode ser nulo.

Exemplos

Exemplo #1 Exemplo de locale_get_display_language()

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

Exemplo #2 Exemplo OO

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

O exemplo acima produzirá:

Slovenian;
slov\xc3\xa8ne;
Slowenisch

Veja Também

locale_get_display_name() - Retorna um nome apropriadamente localizado para a localidade
locale_get_display_script() - Retorna um nome apropriadamente localizado para o tipo de escrita da localidade
locale_get_display_region() - Retorna um nome apropriadamente localizado para a região da localidade
locale_get_display_variant() - Retorna um nome apropriadamente localizado para as variantes da localidade

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