NAME    [Toc]    [Back]

     catgets - retrieve string from message catalog

SYNOPSIS    [Toc]    [Back]

     #include <nl_types.h>

     char *
     catgets(nl_catd catd, int set_id, int msg_id, char *s);

DESCRIPTION    [Toc]    [Back]

     The catgets() function attempts to retrieve  message  msg_id
of set set_id
     from  the message catalog referenced by the descriptor catd.
The argument
     s points to a default message which is returned if the function is unable
     to retrieve the specified message.

RETURN VALUES    [Toc]    [Back]

     If   the   specified  message  was  retrieved  successfully,
catgets() returns a
     pointer to an internal buffer containing the message string;
otherwise it
     returns s.

SEE ALSO    [Toc]    [Back]

     catclose(3), catopen(3)

STANDARDS    [Toc]    [Back]

     The  catgets() function conforms to X/Open Portability Guide
Issue 3
     (``XPG3'').

OpenBSD      3.6                           May      29,      1994