iconv_close Subroutine

Purpose

Closes a specified code set converter.

Library

iconv Library (libiconv.a)

Syntax

#include <iconv.h>
int iconv_close ( CD)
iconv_t CD;

Description

The iconv_close subroutine closes a specified code set converter and deallocates any resources used by the converter.

Parameters

Item Description
CD Specifies the conversion descriptor to be closed.

Return Values

When successful, the iconv_close subroutine returns a value of 0. Otherwise, it returns a value of -1 and sets the errno global variable to indicate the error.

Error Codes

The following error code is defined for the iconv_close subroutine:

Item Description
EBADF The conversion descriptor is not valid.