catgets(3C)          COMPATIBILITY FUNCTIONS          catgets(3C)



NAME
     catgets - read 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  cato-
     pen.   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.































                          Last change:                          1