nl_langinfo(3C)                                             nl_langinfo(3C)


   NAME
         nllanginfo - language information

   SYNOPSIS
         #include <nltypes.h>
         #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
         ``Sun'' if the identified language was English.

   SEE ALSO
         gettxt(3C), localeconv(3C), setlocale(3C), strftime(3C), langinfo(5),
         nltypes(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 nllanginfo returns a pointer to the
         corresponding string in the C locale.  In all locales, nllanginfo
         returns a pointer to an empty string if item contains an invalid
         setting.

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

         The nllanginfo 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 nllanginfo.










   8/91                                                                 Page 1