Manual Pages for UNIX Operating System command usage for man nl_langinfo

Standard C Library Functions                      nl_langinfo(3C)



NAME
     nl_langinfo - language information

SYNOPSIS
     #include 

     char *nl_langinfo(nl_item item);


DESCRIPTION
     The nl_langinfo() function returns  a  pointer  to  a  null-
     terminated  string containing information relevant to a par-
     ticular language or cultural area defined  in  the  programs
     locale.  The  manifest constant names and values of item are
     defined by . 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.

RETURN VALUES
     If setlocale(3C) has not been  called  successfully,  or  if
     data for a supported language is either not available, or if
     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.

USAGE
     The nl_langinfo()  function  can  be  used  safely  in  mul-
     tithreaded  applications,  as  long  as setlocale(3C) is not
     being called to change the locale.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:















SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                      nl_langinfo(3C)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     setlocale(3C), langinfo.h(3HEAD), nl_types.h(3HEAD),  attri-
     butes(5), standards(5)

WARNINGS
     The array pointed to by the return value should not be modi-
     fied  by the program. Subsequent calls to  nl_langinfo() may
     overwrite the array.


































SunOS 5.11          Last change: 24 Jul 2002                    2