nl_langinfo(3C)                DG/UX 5.4R3.00                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.



   Considerations for Threads Programming
                    +------------+-----------------------------+
                    |            |                      async- |
                    |function    | reentrant   cancel   cancel |
                    |            |              point    safe  |
                    +------------+-----------------------------+
                    |nllanginfo |     Y          Y        N   |
                    +------------+-----------------------------+
       nllanginfo should be called when the other threads in a process are
       not changing locale information.  See the setlocale(3C) man page for
       more information.


SEE ALSO
       reentrant(3), 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



Licensed material--property of copyright holder(s)                         1

nl_langinfo(3C)                DG/UX 5.4R3.00                nl_langinfo(3C)


       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.



















































Licensed material--property of copyright holder(s)                         2