catgets(3c)


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| C Function Reference \| Local Topics \| Previous Topic \| Next Topic \| Contents

catgets(3c)

Name

catgets()—Reads 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.