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

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. 

SEE ALSO

gettxt(3C), localeconv(3C), setlocale(3C), strftime(3C), langinfo(5), nl_types(5)

DIAGNOSTICS

If setlocale has not been called successfully, or if langinfo 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. 

NOTES

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

The nl_langinfo function is built upon the functions localeconv, strftime, and gettxt [see langinfo(5)].  Where possible users are advised to use these interfaces to the required data instead of using calls to nl_langinfo.