NL_LANGINFO(3C) Standard C Library Functions NL_LANGINFO(3C)

NAME

nl_langinfo, nl_langinfo_l - language information

SYNOPSIS

#include <langinfo.h>

char *nl_langinfo(nl_item item);

char *nl_langinfo_l(nl_item item, locale_t loc);

DESCRIPTION

The nl_langinfo() function returns a pointer to a null-terminated
string containing information relevant to a particular language or
cultural area defined in the programs locale. The manifest constant
names and values of item are defined by <langinfo.h>. For example:

nl_langinfo(ABDAY_1);

would return a pointer to the string "Dim" if the identified language
was French and a French locale was correctly installed; or "Sun" if
the identified language was English.

The function nl_langinfo_l() behaves identically to nl_langinfo(),
except instead of acting in the current locale, it instead acts in
the locale specified by loc.

RETURN VALUES

If the locale has not been set or is invalid, or if data for a
supported language is either not available, or if item is not defined
therein, then these functions return a pointer to the corresponding
string in the C locale. In all locales, they return a pointer to an
empty string if item contains an invalid setting.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

newlocale(3C), setlocale(3C), uselocale(3C), langinfo.h(3HEAD),
nl_types.h(3HEAD), attributes(7), standards(7)

WARNINGS

The array pointed to by the return value should not be modified by
the program. Subsequent calls to these functions may overwrite the
array.

June 24, 2014 NL_LANGINFO(3C)