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 pt_PT.iso88591, and “Su” if the identified language is fi_FI.iso88591. 

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 OSF and HP. 

SEE ALSO

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

STANDARDS CONFORMANCE

nl_langinfo(): AES, SVID3, XPG2, XPG3, XPG4

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996