NAME

nl_langinfo − language information

SYNOPSIS

#include <nl_types.h>
#include <langinfo.h>

char ∗nl_langinfo(nl_item item);

MT-LEVEL

Safe with exceptions

DESCRIPTION

nl_langinfo() returns a pointer to a null-terminated string containing information relevant to a particular language or cultural area defined in the programs locale.  The manifest constant names and values of item are defined by <langinfo.h>. 

Since yes and no strings are implemented using gettext(3I), link with the −lintl library. 

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. 

EXAMPLES

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. 

SEE ALSO

gettext(3I), localeconv(3C), setlocale(3C), strftime(3C), langinfo(5), nl_types(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. 

This function is built upon the functions localeconv(), strftime(), and gettext().  Where possible users are advised to use these interfaces to the required data instead of using calls to nl_langinfo(). 

NOTES

nl_langinfo can be used safely in a multi-thread application, as long as setlocale(3C) is not being called to change the locale. 

SunOS 5.4  —  Last change: 22 Jan 1993