catgets(3C)                                                     catgets(3C)


   NAME
         catgets - read a program message

   SYNOPSIS
         #include <nltypes.h>

         char *catgets (nlcatd catd, int setnum, int msgnum,
                        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. These strings may be placed in read-only memory.  If
         the call is unsuccessful because the message catalogue identified by
         catd is not currently available, a pointer to s is returned.




























   8/91                                                                 Page 1