HPUX nl_langinfo[3c]






 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 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            - 1 -     HP-UX Release 9.0: August 1992