ATMI C Function Reference
|
 |
 |
|
 |
 |
catgets(3c)
Name
catgets()—Reads a program message.
Synopsis
#include <nl_types.h>
char *catgets (nl_catd catd, int set_num, int msg_num, char *s)
Description
catgets() attempts to read message msg_num, in set set_num, from the message catalogue identified by catd. catd is a catalogue descriptor returned from an earlier call to catopen(). s points to a default message string which will be returned by catgets() if the identified message catalogue is not currently available.
A thread in a multithreaded application may issue a call to catgets() while running in any context state, including TPINVALIDCONTEXT.
Diagnostics
If the identified message is retrieved successfully, catgets() returns a pointer to an internal buffer area containing the NULL terminated message string. If the call is unsuccessful because the message catalogue identified by catd is not currently available, a pointer to s is returned.
