nl_langinfo_l(3) [osx man page]

NL_LANGINFO(3)						   BSD Library Functions Manual 					    NL_LANGINFO(3)

NAME

     nl_langinfo, nl_langinfo_l -- language information

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <langinfo.h>

     char *
     nl_langinfo(nl_item item);

     #include <langinfo.h>
     #include <xlocale.h>

     char *
     nl_langinfo_l(nl_item item, locale_t loc);

DESCRIPTION

     The nl_langinfo() function returns a pointer to a string containing information relevant to the particular language or cultural area defined
     in the program's locale.  The manifest constant names and values of item are defined in <langinfo.h>.

     Calls to setlocale() with a category corresponding to the category of item, or to the category LC_ALL, may overwrite the buffer pointed to by
     the return value.

EXAMPLES

     For example:

	   nl_langinfo(ABDAY_1)

     would return a pointer to the string "Dom" if the identified language was Portuguese, and "Sun" if the identified language was English.

     While the nl_langinfo() function uses the current locale, the nl_langinfo_l() function may be passed a locale directly. See xlocale(3) for
     more information.

RETURN VALUES

     In a locale where langinfo data is not defined, nl_langinfo() returns a pointer to the corresponding string in the POSIX locale.  In all
     locales, nl_langinfo() returns a pointer to an empty string if item contains an invalid setting.

SEE ALSO

     setlocale(3), xlocale(3)

STANDARDS

     The nl_langinfo() function conforms to Version 2 of the Single UNIX Specification (``SUSv2'').

HISTORY

     The nl_langinfo() function first appeared in FreeBSD 4.6.

BSD
								    May 3, 2001 							       BSD

nl_langinfo(3C) 					   Standard C Library Functions 					   nl_langinfo(3C)

NAME

       nl_langinfo - language information

SYNOPSIS

       #include <langinfo.h>

       char *nl_langinfo(nl_item item);

DESCRIPTION

       The  nl_langinfo()  function returns a pointer to a null-terminated string containing information relevant to a particular language or cul-
       tural 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.

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 multithreaded applications, as long as setlocale(3C) is not being called to change the
       locale.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       setlocale(3C), langinfo.h(3HEAD), nl_types.h(3HEAD), attributes(5), standards(5)

WARNINGS

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

SunOS 5.11							    24 Jul 2002 						   nl_langinfo(3C)