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 message
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 subse‐
quent calls to and If unsuccessful, returns ()-1.
The function returns 0 if successful, otherwise -1.
See Alsointro(3int), setlocale(3), catgetmsg(3int), catgets(3int), envi‐
ron(5int), nl_types(5int)
Guide to Developing International Software
catopen(3int)