BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference

catgets(3c)

Name

catgets() - read a program message

Synopsis

#include <nl_types.h> 
char *catgets (nl_catd catd, int set_num, int msg_num, char *s)

Description

catgets() attempts to read message msg_num, in set set_num, from the 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.

A thread in a multithreaded application may issue a call to catgets() while running in any context state, including TPINVALIDCONTEXT.

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