catclose() — Close a message catalog descriptor

Standards

Standards / Extensions C or C++ Dependencies
XPG4
XPG4.2
Single UNIX Specification, Version 3
both  

Format

#define _XOPEN_SOURCE
#include <nl_types.h>

int catclose(nl_catd catd);

General description

The catclose() function closes the message catalog identified by catd. If a catalog is opened more than once in the same process, a use count is incremented. catclose() decrements this use count. When the use count reaches zero then the file descriptor for that catalog is closed.

Returned value

If successful, catclose() returns 0.

If unsuccessful, catclose() returns -1 and sets errno to one of the following values:
Error Code
Description
EBADF
The catalog descriptor is not valid.
EINTR
catclose() was interrupted by a signal.

Related information