NLLANGINFO(3C-SVR4)RISC/os Reference Manual NLLANGINFO(3C-SVR4)



NAME
     nl_langinfo - 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:

          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.

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

DIAGNOSTICS
     If setlocale has not been called successfully, or if lan-
     ginfo 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 modi-
     fied 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.











                        Printed 11/19/92                   Page 1