NLCATGETS(2,L) AIX Technical Reference NLCATGETS(2,L) ------------------------------------------------------------------------------- NLcatgets PURPOSE Access a message catalog the first time after NLcatopen opens the catalog. LIBRARY Standard C Library (libc.a) SYNTAX #include <nl_types.h> char *NLcatgets (catd, set_num, msg_num, s) nl_catd catd; int set_num, msg_num; char *s; DESCRIPTION If NLcatopen is used to prepare a message catalog for access, then NLcatgets must be used to access the message catalog the first time. A successful call to NLcatopen returns catd. The set and message to retrieve from the catalog is specified by set_num and msg_num. The pointer to a default string to return if the call fails is s. RETURN VALUE Upon successful completion, NLcatgets returns a pointer to the message string from the message catalog. The data held at this location is overwritten on the next call to NLcatgets, so it is up to the user program to copy the data and save it before the next call to NLcatgets. NLcatgets returns a pointer to the default string s upon failure. Processed November 7, 1990 NLCATGETS(2,L) 1