NAME

catclose − Closes a specified message catalog

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <nl_types.h> int catclose(
nl_catd cat_descriptor);

PARAMETERS

cat_descriptor
Specifies an index into the message catalog that is returned from a call to the catopen() function. 

DESCRIPTION

The catclose() function closes a message catalog specified by the cat_descriptor parameter.  If a file descriptor is used to implement the type nl_catd, that file descriptor will be closed. 

Before exiting, programs should close any 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. 

AES Support Level:
Trial use.

RETURN VALUES

Upon successful completion, a value of 0 (zero) is returned.  If the cat_descriptor parameter value is not valid, the catclose() function returns a value of -1. 

RELATED INFORMATION

Functions: catopen(3), catgets(3). 

Commands: dspcat(1), dspmsg(1), gencat(1), mkcatdefs(1).