nl_langinfo(3C) Standard C Library Functions nl_langinfo(3C)NAMEnl_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 applica‐
tions, 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 │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe with exceptions │
├─────────────────────────────┼─────────────────────────────┤
│Standard │See standards(5). │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsetlocale(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)