catgets(3C) — DG/UX R4.11



catgets(3C)                       SDK R4.11                      catgets(3C)


NAME
       catgets - read a program message

SYNOPSIS
       #include <nltypes.h>
       char *catgets(nlcatd catd, int setnum, int msgnum, const 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 successful 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.

   Return Values
       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 value of
       s is returned.


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

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



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