NAME    [Toc]    [Back]

       catclose - Close a specified message catalog

SYNOPSIS    [Toc]    [Back]

       #include <nl_types.h>

       int catclose(
               nl_catd cat_descriptor );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Specifies  a  message catalog descriptor that was returned
       from a call to the catopen() function.

DESCRIPTION    [Toc]    [Back]

       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 catalogs must be  closed  before  more
       can be opened.

NOTES    [Toc]    [Back]

       The  cat_descriptor  pointer  is  not  valid once the catclose()
 function has been called for that  cat_descriptor.

RETURN VALUES    [Toc]    [Back]

       On  successful completion, the catclose() function returns
       a value of 0 (zero). Otherwise,  the  function  returns  a
       value  of -1.  (The function will return -1 if interrupted
       by a signal or if the catalog descriptor is invalid.)

ERRORS    [Toc]    [Back]

       The catalog descriptor is not valid.

SEE ALSO    [Toc]    [Back]

       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



                                                      catclose(3)