ICONV_CLOSE(3C) Standard C Library Functions 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; otherwise, 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 attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


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


July 24, 2002 ICONV_CLOSE(3C)