CATGETS(3)                OpenBSD Programmer's Manual               CATGETS(3)

NAME
     catgets - retrieve string from message catalog



SYNOPSIS
     #include <nl_types.h>

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

DESCRIPTION
     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
     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
     catclose(3),  catopen(3)

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

OpenBSD 2.6                      May 29, 1994                                1