HPlogo HP-UX Reference Volume 4 of 5 > n

nl_langinfo(3C)

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

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.

STANDARDS CONFORMANCE

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

© Hewlett-Packard Development Company, L.P.