NOMBRE¶

nl_langinfo, nl_langinfo_l - consulta información de idioma y localización

SINOPSIS¶

#include <langinfo.h>

char *nl_langinfo(nl_item item);

char *nl_langinfo_l(nl_item item, locale_t locale);

Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

nl_langinfo_l():

DESCRIPCIÓN¶

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.

Ejemplos de los elementos de localización que pueden especificarse en item usando las constantes definidas en <langinfo.h> son:

CODESET (LC_CTYPE)

Devuelve una cadena con el nombre de la codificación de caracteres usada en la localización seleccionada, tal como "UTF-8", "ISO-8859-1", o "ANSI_X3.4-1968" (mejor conocida como US-ASCII). Ésta es la misma cadena que se obtiene con "locale charmap". Para una lista de nombres de codificaciones de caracteres, pruebe "locale -m" (vea locale(1)).

D_T_FMT (LC_TIME)

Devuelve una cadena que puede emplearse como cadena de formato en strftime(3) para representar la hora y la fecha de manera específica para la localización.

D_FMT (LC_TIME)

Devuelve una cadena que puede emplearse como cadena de formato en strftime(3) para representar una fecha de manera específica para la localización.

T_FMT (LC_TIME)

Devuelve una cadena que puede emplearse como cadena de formato en strftime(3) para representar una hora de manera específica para la localización.

DAY_{1–7} (LC_TIME)

Devuelve el nombre del n-ésimo día de la semana. [Advertencia: se sigue la convención de EEUU, DÍA_1 = Domingo (Sunday), no la convención internacional (ISO 8601) de que el Lunes (Monday) es el primer día de la semana.]

ABDAY_{1–7} (LC_TIME)

Devuelve el nombre abreviado del n-ésimo día de la semana.

MON_{1–12} (LC_TIME)

Devuelve el nombre del n-ésimo mes.

ABMON_{1–12} (LC_TIME)

Devuelve el nombre abreviado del n-ésimo mes.

RADIXCHAR (LC_NUMERIC)

Devuelve el carácter radical (punto decimal, coma decimal, etc.).

THOUSEP (LC_NUMERIC)

Devuelve el carácter separador de miles (grupos de tres dígitos).

YESEXPR (LC_MESSAGES)

Devuelve una expresión regular que puede utilizarse con la función regex(3) para reconocer una respuesta positiva a una pregunta de sí/no.

NOEXPR (LC_MESSAGES)

Devuelve una expresión regular que puede utilizarse con la función regex(3) para reconocer una respuesta negativa a una pregunta de sí/no.

CRNCYSTR (LC_MONETARY)

Devuelve el símbolo monetario, precedido por "-" si el símbolo debiera aparecer antes del valor, "+" si el símbolo debiera aparecer después del valor, o "." si el símbolo debiera reemplazar al carácter radical.

La lista de arriba cubre sólo algunos ejemplos de elementos que pueden ser consultados. Para una lista más detallada, consulte The GNU C Library Reference Manual.

VALOR DEVUELTO¶

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.

Si item no es válido, se devuelve un puntero a una cadena vacía.

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 obtener una explicación de los términos usados en esta sección, véase attributes(7).

CONFORME A¶

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.

EJEMPLO¶

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);
}

VÉASE TAMBIÉN¶

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

The GNU C Library Reference Manual

COLOFÓN¶

Esta página es parte de la versión 4.16 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN¶

La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.