OSF

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. 

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. 

Before exiting, programs should close any catalogs they have opened. 

NOTES

AES Support Level:
Trial use

RETURN VALUES

Upon successful completion, 0 (zero) is returned.  Otherwise, −1 is returned.  The catclose() function fails if the cat_descriptor parameter value is not valid. 

RELATED INFORMATION

Functions: catopen(3), catgets(3)

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