catgets(3C)                    DG/UX 5.4R3.00                    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.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |              point    safe  |
                     +---------+-----------------------------+
                     |catgets  |     Y          N        N   |
                     +---------+-----------------------------+

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, the pointer
       s is returned.

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






















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