catclose(3) Library Functions Manual catclose(3)
NAME
catclose - Closes a specified message catalog
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <nl_types.h>
int catclose( nl_catd cat_descriptor);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
catclose(): XPG4
Refer to the standards(5) reference page for more information about industry standards and associated tags.
PARAMETERS
Specifies a message catalog descriptor that was returned from a call to the catopen() function.
DESCRIPTION
The catclose() function closes the message catalog identified by cat_descriptor.
Before exiting, programs should close any message catalogs they have opened.
If a program accesses several message catalogs, the NL_MAXOPEN number of open catalogs can be reached. In this event, some message cata-
logs must be closed before more can be opened.
NOTES
The cat_descriptor pointer is not valid once the catclose() function has been called for that cat_descriptor.
RETURN VALUES
On successful completion, the catclose() function returns a value of 0 (zero). Otherwise, the function returns a value of -1. (The func-
tion will return -1 if interrupted by a signal or if the catalog descriptor is invalid.)
ERRORS
The catalog descriptor is not valid.
RELATED INFORMATION
Functions: catgets(3), catopen(3)
Commands: dspcat(1), dspmsg(1), extract(1), gencat(1), mkcatdefs(1), strextract(1), strmerge(1), trans(1)
Others: i18n_intro(5), l10n_intro(5), standards(5)
Writing Software for the International Market delim off
catclose(3)
