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)
