NL_LANGINFO(3C)

NAME

nl_langinfo − language information

SYNOPSIS

#include <nl_types.h>
#include <langinfo.h>

char ∗nl_langinfo (item)
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 )

would return a pointer to the string “Dom” if the language identified by the current locale was Portuguese, and “Sun” if the identified language was 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.

Museum

Related Articles