NOME¶

nl_langinfo, nl_langinfo_l - linguagem de pesquisa e informação da localização

SINOPSE¶

#include <langinfo.h>

char *nl_langinfo(nl_item item);

char *nl_langinfo_l(nl_item item, locale_t locale);

Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

nl_langinfo_l():

DESCRIÇÃO¶

The nl_langinfo() and nl_langinfo_l() functions provide access to locale information in a more flexible way than localeconv(3). nl_langinfo() returns a string which is the value corresponding to item in the program's current global locale. nl_langinfo() returns a string which is the value corresponding to item for the locale identified by the locale object locale, which was previously created by newlocale(1). Individual and additional elements of the locale categories can be queried.

Exemplos para os elementos de localidade que podem ser especificados em item usando-se as constantes definidas em <langinfo.h> são:

CODESET (LC_CTYPE)

Retorna uma seqüencia com o nome do caracter codificado como usado na localização selecionado, tal como 'UTF-8', 'ISO-8859-1', ou 'ANSI_X3.4-1968' (melhor conhecido como US-ASCII). Esta é a mesma que você obtem com 'locale charmap'. Para uma lista de nomes de caracteres codificado, tente 'locale -m', veja locale(1).

D_T_FMT (LC_TIME)

Retorna uma seqüencia que pode ser usada como uma seqüencia de formatação para strftime(3) re-apresentar a hora e data de modo específico à localização.

D_FMT (LC_TIME)

Retorna uma seqüencia que pode ser usada como uma seqüencia de formatação para strftime(3) re-apresentar a data de modo específico à localização.

T_FMT (LC_TIME)

Retorna uma seqüencia que pode ser usada como uma seqüencia de formatação para strftime(3) re-apresentar a hora de modo específico à localização.

DAY_{1–7} (LC_TIME)

Retorna o nome do n-ésimo dia da semana. [Atenção: isto segue a convenção dos E.U.A., onde DAY_1 = Domingo, e não a convenção internacional (ISO 8601) na qual, Segunda-Feira é o primeiro dia da semana.]

ABDAY_{1–7} (LC_TIME)

Retorna o nome abreviado do n-ésimo dia da semana.

MON_{1–12} (LC_TIME)

Retorna o nome do n-ésimo mês.

ABMON_{1–12} (LC_TIME)

Retorna o nome abreviado do n-ésimo mês.

RADIXCHAR (LC_NUMERIC)

Retorna o caracter radix (ponto decimal, vírgula decimal, etc.).

THOUSEP (LC_NUMERIC)

Retorna o caracter separador para milhares (grupo de três digitos).

YESEXPR (LC_MESSAGES)

Retorna uma expressão regular que pode ser usado com a função regex(3) para reconhecer uma resposta positiva para uma pergunta sim/não.

NOEXPR (LC_MESSAGES)

Retorna uma expressão regular que pode ser usada com a função regex(3) para reconhecer uma resposta negativa para uma pergunta sim/não.

CRNCYSTR (LC_MONETARY)

Retorna o símbolo atual, precedido por '-' se o símbolo deveria aparecer antes do valor, '+' se o símbolo deveria aparecer após o valor, ou '.' se o símbolo deveria substituir o caracter radix.

A lista acima, cobre somente alguns exemplos dos ítens que podem ser solicitado. Para uma lista mais detalhada, consulte The GNU C Library Reference Manual.

VALOR DE RETORNO¶

On success, these functions return a pointer to a string which is the value corresponding to item in the specified locale.

If no locale has been selected by setlocale(3) for the appropriate category, nl_langinfo() return a pointer to the corresponding string in the "C" locale. The same is true of nl_langinfo_l() if locale specifies a locale where langinfo data is not defined.

Se item não é válido, um indicador para uma seqüencia vazia é retornada.

The pointer returned by these functions may point to static data that may be overwritten, or the pointer itself may be invalidated, by a subsequent call to nl_langinfo(), nl_langinfo_l(), or setlocale(3). The same statements apply to nl_langinfo_l() if the locale object referred to by locale is freed or modified by freelocale(3) or newlocale(3).

POSIX specifies that the application may not modify the string returned by these functions.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

DE ACORDO COM¶

POSIX.1-2001, POSIX.1-2008, SUSv2.

NOTAS¶

The behavior of nl_langinfo_l() is undefined if locale is the special locale object LC_GLOBAL_LOCALE or is not a valid locale object handle.

EXEMPLO¶

The following program sets the character type and the numeric locale according to the environment and queries the terminal character set and the radix character.

#include <langinfo.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{


    setlocale(LC_CTYPE, "");


    setlocale(LC_NUMERIC, "");


    printf("%s\n", nl_langinfo(CODESET));


    printf("%s\n", nl_langinfo(RADIXCHAR));


    exit(EXIT_SUCCESS);
}

VEJA TAMBÉM¶

locale(1), localeconv(3), setlocale(3), charsets(7), locale(7)

The GNU C Library Reference Manual

COLOFÃO¶

Esta página faz parte da versão 4.16 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Ricardo C.O.Freitas <english.quest@best-service.com> e André Luiz Fassone <lonely_wolf@ig.com.br>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.