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 catopen 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 NLSPATH is used with name substituted for %N. For more information, see environ() in the ULTRIX Reference Pages. If NLSPATH does not exist in the environment, or if a message catalog cannot be opened in any of the paths specified by NLSPATH, 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 catclose closes the message catalog identified by catd.

Restrictions

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

Return Values

If successful, catopen returns a message catalog descriptor for use on subsequent calls to catgetmsg, catgets and catclose. If unsuccessful, catopen returns ( nl_catd )-1.

The catclose function returns 0 if successful, otherwise −1.

Museum