NLCATOPEN(2,L) AIX Technical Reference NLCATOPEN(2,L) ------------------------------------------------------------------------------- NLcatopen PURPOSE Deferred open of a message catalog. LIBRARY Standard C Library (libc.a) SYNTAX #include <nl_types.h> nl_catd NLcatopen (filename) char *filename; DESCRIPTION The NLcatopen subroutine provides a mechanism that prepares a message catalog to be accessed without the overhead of opening the catalog until the first call to NLcatgets, when the catalog is actually accessed. If NLcatgets is not used after a call to NLcatopen, undefined results occur since no information regarding the message catalog has been prepared. There is no NLcatclose routine to close a catalog that has been opened by NLcatopen. Use catclose to close a catalog that is opened by NLcatopen and accessed by NLcatgets. RETURN VALUE A catalog descriptor is returned upon successful completion. Otherwise, (nl_catd)-1 will be returned to indicate any failure. The same rules hold true when opening the catalog specified by filename as with the catopen routine. Processed November 7, 1990 NLCATOPEN(2,L) 1