Standard C Library Functions                      nllanginfo(3C)



NAME
     nllanginfo - language information

SYNOPSIS
     #include 

     char *nllanginfo(nlitem item);


DESCRIPTION
     The nllanginfo() 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:


     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.

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

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

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















SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                      nllanginfo(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     CSI                          Enabled                     
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     setlocale(3C), langinfo.h(3HEAD), nltypes.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  nllanginfo() may
     overwrite the array.




































SunOS 5.11          Last change: 24 Jul 2002                    2