iconv_close() — Deallocate code conversion descriptor

Standards

Standards / Extensions C or C++ Dependencies

XPG4
XPG4.2
Single UNIX Specification, Version 3

both  

Format

#include <iconv.h>

int iconv_close(iconv_t cd);

General description

Deallocates the conversion descriptor cd and all other associated resources allocated by the iconv_open() function. For an illustration of using iconv_open(), see Example.

Returned value

If successful, iconv_close() returns 0.

If unsuccessful, iconv_close() returns -1 and sets errno to one of the following values:
Error Code
Description
EBADF
cd is not a valid descriptor.

Related information