CATGETS(3) BSD Library Functions Manual CATGETS(3)

NAME
     ccaattggeettss - retrieve string from message catalog

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     ccaattggeettss(nlcatd catd, int setid, int msgid, const char *s);

DESCRIPTION
     The ccaattggeettss() function attempts to retrieve message msgid of set setid
     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, ccaattggeettss() returns a
     pointer to an internal buffer containing the message string; otherwise it
     returns s.

SEE ALSO
     gencat(1), catclose(3), catopen(3)

STANDARDS     The ccaattggeettss() function conforms to X/Open Portability Guide Issue 4
     (``XPG4'').

BSD                              May 29, 1994                              BSD