NAME

nl_langinfo() − language information

SYNOPSIS

#include <langinfo.h>

char *nl_langinfo(nl_item item);

DESCRIPTION

nl_langinfo() returns a pointer to a null-terminated string containing information relevant to a particular language or cultural area defined in the program’s locale (see setlocale(3C)). The manifest constant names and values of item are defined in <langinfo.h>.  For example:

nl_langinfo( ABDAY_1 )

returns a pointer to the string “Dom” if the language identified by the current locale is Portuguese, and “Sun” if the identified language is Finnish. 

If an invalid item is specified, a pointer to an empty string is returned.  An empty string can also be returned for a valid item if that item is not applicable to the language or customs of the current locale.  For example, a thousands separator is not used when writing numbers according to the customs associated with the Arabic language. 

EXTERNAL INFLUENCES

Locale

The string returned for a particular item is determined by the locale category specified for that item in langinfo(5).

International Code Set Support

Single- and multi-byte character code sets are supported. 

WARNINGS

nl_langinfo() returns a pointer to a static area that is overwritten on each call. 

AUTHOR

nl_langinfo() was developed by HP. 

SEE ALSO

localeconv(3C), setlocale(3C), hpnls(5), langinfo(5). 

STANDARDS CONFORMANCE

nl_langinfo: XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995