catgets(3C)                                                        catgets(3C)


NAME
     catgets - read a program message

SYNOPSIS
     #include <nl_types.h>

     char *catgets (nl_catd catd, int set_num, int msg_num,
         const 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.

SEE ALSO
     catopen(3C).

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.


                                                                        Page 1