 |
Index for Section 3 |
|
 |
Alphabetical listing for N |
|
nl_langinfo(3)
NAME
nl_langinfo - Returns language or cultural data defined in the current
locale
LIBRARY
Standard C Library (libc.so, libc.a)
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(): XPG4
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
item
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.
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