nl_langinfo(3C)                                      nl_langinfo(3C)


       NAME
             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.






                           Copyright 1994 Novell, Inc.               Page 1