nl_types.h

<nl_types.h>(P)						      <nl_types.h>(P)



NAME
       nl_types.h - data types

SYNOPSIS
       #include <nl_types.h>

DESCRIPTION
       The <nl_types.h> header shall contain definitions of at least the fol-
       lowing 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.	 Val-
	      ues of objects of type nl_item are defined in <langinfo.h> .


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

       NL_SETD
	      Used by gencat when no $set directive is specified in a message
	      text source file; see the Internationalization Guide. This con-
	      stant  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_MES-
	      SAGES  locale  category, rather than directly on the LANG envi-
	      ronment 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  Utili-
       ties 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,  Copyright  (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.opengroup.org/unix/online.html .



POSIX				     2003		      <nl_types.h>(P)