#include <nl_types.h> char *
catgets (nl_catd catd int set_id int msg_id const char *s);
DESCRIPTION
The
catgets ();
function attempts to retrieve message
Fa msg_id
of set
Fa set_id
from the message catalog referenced by the descriptor
Fa catd .
The argument
Fa s
points to a default message which is returned if the function
is unable to retrieve the specified message.
RETURN VALUES
If the specified message was retrieved successfully,
catgets ();
returns a pointer to an internal buffer containing the message string;
otherwise it returns
Fa s .
ERRORS
Bq Er EBADF
The
Fa catd
argument is not a valid message catalog descriptor.
Bq Er EBADMSG
The message identified by
Fa set_id
and
Fa msg_id
is not in the message catalog.