ICONV_CLOSE(3C) Standard C Library Functions ICONV_CLOSE(3C)
iconv_close - code conversion deallocation function
#include <iconv.h>
int iconv_close(iconv_t cd);
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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
iconv(3C), iconv_open(3C), attributes(7), standards(7)
July 24, 2002 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)