nl_langinfo(3C)                  UNIX System V                  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.












10/89                                                                    Page 1