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(7) 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(7), standards(7)

July 24, 2002 ICONV_CLOSE(3C)