HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

nl_langinfo(3C) nl_langinfo(3C)

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 par-

ticular language or cultural area deﬁned in the program’s locale (see setlocale (3C)). The manifest con-

stant names and values of

item are deﬁned in <

langinfo.h>. For example:

nl_langinfo(ABDAY_1)

returns a pointer to the string ‘‘Dom’’ if the language identiﬁed by the current locale is pt_PT.iso88591,

and ‘‘Su’’ if the identiﬁed language is ﬁ_FI.iso88591.

If an invalid

item is speciﬁed, 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 associ-

ated with the Arabic language.

EXTERNAL INFLUENCES

Locale

The string returned for a particular

item is determined by the locale category speciﬁed 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.