Name

nl_langinfo()—Language information.

Synopsis

#include <nl_types.h>
#include <langinfo.h>

char *nl_langinfo (nl_item item);

Description

nl_langinfo() 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);

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

A thread in a multithreaded application may issue a call to nl_langinfo() while running in any context state, including TPINVALIDCONTEXT.

Diagnostics

If setlocale() has not been called successfully, or if langinf0() data for a supported language is either not available or item is not defined therein, then nl_langinfo() returns a pointer to the corresponding string in the C locale. In all locales, nl_langinfo() returns a pointer to an empty string if item contains an invalid setting.

Notices

The array pointed to by the return value should not be modified by the program. Subsequent calls to nl_langinfo() may overwrite the array.

See Also