catgets(3C)                      UNIX System V                      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.  If the call is unsuccessful because the message catalogue
      identified by catd is not currently available, a pointer to s is
      returned.






























10/89                                                                    Page 1