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)
Check Out this Related Man Page
catgetmsg(3int) catgetmsg(3int) Name catgetmsg - get message from a message catalog Syntax #include <nl_types.h> char *catgetmsg(catd, set_num, msg_num, buf, buflen) nl_catd catd; int set_num, msg_num, buflen; char *buf; Description The function has been superceded by the function. You should use the function to get messages from a message catalog. You might want to rewrite calls to the function so that they use the function. The function is available for compatibility with XPG-2 conformant software and might not be available in the future. For more information on using see the reference page. The function attempts to read up to buflen -1 bytes of a message string into the area pointed to by buf . The parameter is an integer value containing the size in bytes of buf. The return string is always terminated with a null byte. The parameter catd is a catalog descriptor returned from an earlier call to and identifies the message catalog containing the message set ( set_num) and the program message ( msg_num). The arguments set_num and msg_num are defined as integer values for maximum portability. Where possible, you should use symbolic names for message and set numbers, rather hard-coding integer values into your source programs. If you use symbolic names, you must run prior to and be sure the appropriate include file is used in your program. Return Value If successful, returns a pointer to the message string in buf. Otherwise, if catd is invalid or if set_num or msg_num are not in the mes- sage catalog, returns a pointer to an empty (null) string. See Also intro(3int), gencat(1int), catopen(3int), catgets(3int), nl_types(5int) Guide to Developing International Software catgetmsg(3int)