nl_langinfo(3C) — DG/UX R4.11



nl_langinfo(3C)                   SDK R4.11                  nl_langinfo(3C)


NAME
       nllanginfo - language information

SYNOPSIS
       #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 program's 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.

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

   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.

REFERENCES
       reentrant(3), gettxt(3C), localeconv(3C), setlocale(3C), strftime(3C)
       langinfo(5), nltypes(5),

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


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