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(.). 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 is 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.

The subroutine malloc is used by catopen.

RETURN VALUE

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