<nl_types.h>(0P)                                    POSIX Programmer's Manual                                   <nl_types.h>(0P)



NAME
       nl_types.h - data types

SYNOPSIS
       #include <nl_types.h>

DESCRIPTION
       The <nl_types.h> header shall contain definitions of at least the following types:

       nl_catd
              Used by the message catalog functions catopen(), catgets(), and catclose() to identify a catalog descriptor.

       nl_item
              Used by nl_langinfo() to identify items of langinfo data.  Values of objects of type nl_item are defined in <lang-
              info.h> .


       The <nl_types.h> header shall contain definitions of at least the following constants:

       NL_SETD
              Used by gencat when no $set directive is specified in a message text source  file;  see  the  Internationalization
              Guide.  This  constant can be passed as the value of set_id on subsequent calls to catgets() (that is, to retrieve
              messages from the default message set). The value of NL_SETD is implementation-defined.

       NL_CAT_LOCALE
              Value that must be passed as the oflag argument to catopen() to ensure that message catalog selection  depends  on
              the LC_MESSAGES locale category, rather than directly on the LANG environment variable.


       The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.


              int       catclose(nl_catd);
              char     *catgets(nl_catd, int, int, const char *);
              nl_catd   catopen(const char *, int);

       The following sections are informative.

APPLICATION USAGE
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       <langinfo.h>,  the System Interfaces volume of IEEE Std 1003.1-2001, catclose(), catgets(), catopen(), nl_langinfo(), the
       Shell and Utilities volume of IEEE Std 1003.1-2001, gencat

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2003  Edition,  Standard  for
       Information  Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copy-
       right (C) 2001-2003 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any
       discrepancy  between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group
       Standard  is  the  referee   document.   The   original   Standard   can   be   obtained   online   at   http://www.open-
       group.org/unix/online.html .



IEEE/The Open Group                                           2003                                              <nl_types.h>(0P)