catclose(3)catclose(3)NAMEcatclose - Close a specified message catalog
SYNOPSIS
#include <nl_types.h>
int catclose(
nl_catd cat_descriptor );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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 catalogs
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 function
will return -1 if interrupted by a signal or if the catalog descriptor
is invalid.)
ERRORS
The catalog descriptor is not valid.
SEE ALSO
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
catclose(3)
