catgets(3C)                      DG/UX 5.4.2                     catgets(3C)


NAME
       catgets - read a program message

SYNOPSIS
       #include <nltypes.h>

       char *catgets (nlcatd catd, int setnum, int msgnum, char *s);

DESCRIPTION
       catgets attempts to read message msgnum, in set setnum, from the
       X/Open-style 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.

DIAGNOSTICS
       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.

SEE ALSO
       catopen(3C).
       gettxt(3C) -- AT&T-style message facility.
































Licensed material--property of copyright holder(s)                         1