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).

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

The iconv_close() function may fail if:

EBADF

The conversion descriptor is invalid.

See attributes(5) for descriptions of the following attributes:

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