nl_langinfo(3C)                                             nl_langinfo(3C)

NAME
     nllanginfo - get language information

SYNOPSIS
     #include <langinfo.h>

     char *nllanginfo(nlitem item);

DESCRIPTION
     nllanginfo() 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:

          nllanginfo (ABDAY1);

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

RESULT
     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 nllanginfo() returns a pointer to the corre-
     sponding string in the C locale. If item contains an invalid string,
     nllanginfo() always returns a pointer to an empty string.

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

     Some of the constants defined in langinfo.h are recognized in XPG4
     mode only. If used as input in XPG3 mode, nllanginfo() returns a
     pointer to an empty string. A note to this effect is included in the
     table for langinfo(5).

SEE ALSO
     gettxt(3C), localeconv(3C), setlocale(3C), strftime(3C), LCTIME(4),
     langinfo(5), nltypes(5).














Page 1                       Reliant UNIX 5.44                Printed 11/98