catgets(3C)							   catgets(3C)

NAME    [Toc]    [Back]

     catgets - read a program message

SYNOPSIS    [Toc]    [Back]

     #include <nl_types.h>

     char *catgets (nl_catd catd, int set_num, int msg_num,
	 const char *s);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     catopen(3C).

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111