Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

catclose(3) Guardian Native C Library Calls Reference Manual

NAME

catclose - Closes a speciﬁed message catalog

LIBRARY

G-series native OSS processes: /G/system/sysnn/zcrtlsrl

32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll

64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll

SYNOPSIS

#include <nl_types.h>

int catclose (

nl_catd cat_descriptor);

PARAMETERS

cat_descriptor Speciﬁes an index into the message catalog that is returned from a call to the

catopen() function.

DESCRIPTION

The catclose() function closes a message catalog speciﬁed by the cat_descriptor parameter.

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 returned cat_descriptor pointer is not valid once the catclose() function has been called for

that cat_descriptor.

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: gencat(1), mkcatdefs(1).

1−84 Hewlett-Packard Company 527192-018