nl_langinfo(3) Library Functions Manual nl_langinfo(3)
NAME
nl_langinfo - Returns language or cultural data defined in the current locale
LIBRARY
Standard C Library (libc)
SYNOPSIS
#include <langinfo.h>
char *nl_langinfo(
nl_item item);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
nl_langinfo(): XSH5.0
Refer to the standards(5) reference page for more information about industry standards and associated tags.
PARAMETERS
Specifies a constant name or value.
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 constant names and values that are valid for the item parameter are defined in the langinfo.h header
file.
The array pointed to by the return value may contain static data that is overridden on the next call to nl_langinfo(). This array should
not be modified by the application, only by further calls to nl_langinfo().
The XSH specification does not require the nl_langinfo() function to be re-entrant.
EXAMPLES
The following example returns a pointer to the abbreviated name of the first day of the week in the current locale:
nl_langinfo(ABDAY_1)
This function call would return a pointer to the string "Dom" if the identified language was Portuguese, "Sun" if the identified language
was English, and so on.
RETURN VALUES
In a locale where langinfo data is not defined, the nl_langinfo() function returns a pointer to the corresponding string in the POSIX (C)
locale. In all locales, the nl_langinfo() function returns a pointer to an empty string if the item parameter contains an invalid setting.
RELATED INFORMATION
Functions: localeconv(3), setlocale(3), strfmon(3)
Others: i18n_intro(5), l10n_intro(5), standards(5)
Writing Software for the International Market delim off
nl_langinfo(3)
