nl_langinfo(3C)

nl_langinfo -- language information

Synopsis

   #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 program's 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.

Errors

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.

References

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

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.

The nl_langinfo function is built on 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.