catopen(3int) [ultrix man page]

catopen(3int)															     catopen(3int)

Name
       catopen, catclose - open/close a message catalog

Syntax
       #include <nl_types.h>

       nl_catd catopen (name, oflag)
       char *name;
       int oflag;

       int catclose (catd)
       nl_catd catd;

Description
       The  function opens a message catalog and returns a catalog descriptor.	The parameter name specifies the name of the message catalog to be
       opened.	If name contains a slash (/), then name specifies a pathname for the message catalog.  Otherwise, the environment variable is used
       with name substituted for %N.  For more information, see in the ULTRIX Reference Pages.	If does not exist in the environment, or if a mes-
       sage catalog cannot be opened in any of the paths specified by the current directory is used.

       The oflag is reserved for future use and must be set to zero(0).  The results of setting this field to any other value are undefined.

       The function closes the message catalog identified by

Restrictions
       Using causes another file descriptor to be allocated by the calling process for the duration of the call.

Return Values
       If successful, returns a message catalog descriptor for use on subsequent calls to and If unsuccessful, returns ()-1.

       The function returns 0 if successful, otherwise -1.

See Also
       intro(3int), setlocale(3), catgetmsg(3int), catgets(3int), environ(5int), nl_types(5int)
       Guide to Developing International Software

																     catopen(3int)

CATOPEN(3)						   BSD Library Functions Manual 						CATOPEN(3)

NAME

     catopen -- open message catalog

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <nl_types.h>

     nl_catd
     catopen(const char *name, int oflag);

DESCRIPTION

     The catopen() function opens the message catalog specified by name and returns a message catalog descriptor.  If name contains a '/' then
     name specifies the full pathname for the message catalog, otherwise the value of the environment variable NLSPATH is used with the following
     substitutions:

     %N   The value of the name argument.

     %L   The value of the LANG environment variable or the LC_MESSAGES category (see below).

     %l   The language element from the LANG environment variable or from the LC_MESSAGES category.

     %t   The territory element from the LANG environment variable or from the LC_MESSAGES category.

     %c   The codeset element from the LANG environment variable or from the LC_MESSAGES category.

     %%   A single % character.

     An empty string is substituted for undefined values.

     Path names templates defined in NLSPATH are separated by colons (':').  A leading or two adjacent colons is equivalent to specifying %N.

     If the oflag argument is set to the NL_CAT_LOCALE constant, LC_MESSAGES locale category used to open the message catalog; using NL_CAT_LOCALE
     conforms to the X/Open Portability Guide Issue 4 (``XPG4'') standard.  You can specify 0 for compatibility with X/Open Portability Guide
     Issue 3 (``XPG3''); when oflag is set to 0, the LANG environment variable determines the message catalog locale.

     A message catalog descriptor remains valid in a process until that process closes it, or until a successful call to one of the exec(3) func-
     tion.

RETURN VALUES

     Upon successful completion, catopen() returns a message catalog descriptor.  Otherwise, (nl_catd) -1 is returned and errno is set to indicate
     the error.

ERRORS

     [EINVAL]		Argument name does not point to a valid message catalog, or catalog is corrupt.

     [ENAMETOOLONG]	An entire path to the message catalog exceeded 1024 characters.

     [ENOENT]		The named message catalog does not exists, or the name argument points to an empty string.

     [ENOMEM]		Insufficient memory is available.

SEE ALSO

     gencat(1), catclose(3), catgets(3), setlocale(3)

STANDARDS

     The catopen() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

BSD
								 February 12, 2005							       BSD