iconv_close(3C)

NAME

     iconv_close - code conversion deallocation function

SYNOPSIS

     #include <iconv.h>

     int iconv_close(iconv_t cd);

DESCRIPTION

     The  iconv_close()  function  deallocates   the   conversion
     descriptor  cd  and all other associated resources allocated
     by the iconv_open(3C) function.

     If a file descriptor is used to implement the type  iconv_t,
     that file descriptor will be closed.

     For  examples  using   the   iconv_close()   function,   see
     iconv(3C).

RETURN VALUES

     Upon successful completion, iconv_close() returns 0;  other-
     wise, it returns -1 and sets errno to indicate the error.

ERRORS

     The  iconv_close() function may fail if:

     EBADF The conversion descriptor is invalid.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     iconv(3C), iconv_open(3C), attributes(5)