Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

SunOS 5.10 - man page for nl_langinfo (sunos section 3c)

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.10 24 Jul 2002 nl_langinfo(3C)