Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

Check Out this Related Man Page

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)
Man Page