catclose(3) [freebsd man page]

CATCLOSE(3)						   BSD Library Functions Manual 					       CATCLOSE(3)

NAME

     catclose -- close message catalog

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <nl_types.h>

     int
     catclose(nl_catd catd);

DESCRIPTION

     The catclose() function closes the message catalog specified by the argument catd.

RETURN VALUES

     The catclose() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indi-
     cate the error.

ERRORS

     [EBADF]		An invalid message catalog descriptor was passed by the catd argument.

SEE ALSO

     gencat(1), catgets(3), catopen(3)

STANDARDS

     The catclose() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

BSD
								 February 12, 2005							       BSD

catclose(3)						     Library Functions Manual						       catclose(3)

NAME

       catclose - Closes a specified message catalog

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <nl_types.h>

       int catclose(	  nl_catd cat_descriptor);

STANDARDS

       Interfaces documented on this reference page conform to industry standards 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 cata-
       logs 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  func-
       tion will return -1 if interrupted by a signal or if the catalog descriptor is invalid.)

ERRORS

       The catalog descriptor is not valid.

RELATED INFORMATION

       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 delim off

																       catclose(3)