[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    catgets(3C) manual page Table of Contents

Name

catgets - read a program message

Synopsis

#include <nl_types.h>

char *catgets(nl_catd catd, int set_num, int msg_num, const char *s);

MT-Level

MT-Safe

Description

catgets() attempts to read message msg_num, in set set_num, from the message catalog identified by catd. catd is a catalog 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 catalog 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 for any reason, catgets() returns a pointer to s.

See Also

gencat(1) , catopen(3C) , gettext(3I) , setlocale(3C)

Notes

catgets can be used safely in a multi-thread application, as long as setlocale(3C) is not being called to change the locale.

Table of Contents