catgets
-read a program message
#include <nl_types.h>
char *catgets (nl_catd catd, int set_num, int msg_num, char *s)
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
(3). s
points to a default message string which will be returned by catgets
if the identified message catalogue is not currently available.
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.
catopen
(3).