NAME

iconv_close − Closes a specified codeset converter

LIBRARY

The iconv Library (libiconv.so, libiconv.a)

SYNOPSIS

#include <iconv.h>

int iconv_close(
        iconv_t cd);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

iconv_close():  XPG4

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

cdSpecifies the descriptor of the converter to be closed

DESCRIPTION

The iconv_close() function closes a converter previously opened with iconv_open() and deallocates any resources used by the specified converter. 

RETURN VALUES

On successful completion, the iconv_close() function returns a value of zero. Otherwise, the function returns a value of −1 and sets errno to indicate the error. 

ERRORS

If the following condition occurs, the iconv_close() function sets errno to the corresponding value:

[EBADF]The converter’s file descriptor is invalid. 

RELATED INFORMATION

Functions: iconv(3), iconv_open(3)

Commands: genxlt(1), iconv(1)

Others: iconv_intro(5), standards(5)