NL_LANGINFO(3) Library Functions Manual NL_LANGINFO(3)

nl_langinfo, nl_langinfo_llanguage information

Standard C Library (libc, -lc)

#include <langinfo.h>

char *
nl_langinfo(nl_item item);

#include <langinfo.h>
#include <xlocale.h>

char *
nl_langinfo_l(nl_item item, locale_t loc);

The () function returns a pointer to a string containing information relevant to the particular language or cultural area defined in the program's locale. The manifest constant names and values of item are defined in <langinfo.h>.

Calls to () with a category corresponding to the category of item, or to the category LC_ALL, may overwrite the buffer pointed to by the return value.

In a locale where langinfo data is not defined, nl_langinfo() returns a pointer to the corresponding string in the POSIX locale. In all locales, nl_langinfo() returns a pointer to an empty string if item contains an invalid setting.

For example:

nl_langinfo(ABDAY_1)

would return a pointer to the string "Dom" if the identified language was Portuguese, and "Sun" if the identified language was English.

While the nl_langinfo() function uses the current locale, the nl_langinfo_l() function may be passed a locale directly. See xlocale(3) for more information.

setlocale(3), xlocale(3)

The nl_langinfo() function conforms to Version 2 of the Single UNIX Specification (“SUSv2”).

The nl_langinfo() function first appeared in FreeBSD 4.6.

May 3, 2001 Mac OS X 12