KICONV_CLOSE(9F) Kernel Functions for Drivers KICONV_CLOSE(9F)

kiconv_close - code conversion descriptor deallocation function

#include <sys/errno.h>
#include <sys/sunddi.h>
int kiconv_close(kiconv_t cd);

illumos DDI specific (illumos DDI).

cd

Code conversion descriptor to be deallocated.

The kiconv_close() function deallocates the conversion descriptor cd and all other associated resources allocated by the kiconv_open() function.

Upon successful completion, kiconv_close() returns 0; otherwise, it returns the following errno value to indicate the error:

EBADF

The code conversion descriptor is invalid.

kiconv_close() can be called from user or interrupt context.

Example 1 Closing the Code Conversion

The following example shows how to close the code conversion descriptor with error checking:


if (kiconv_close(cd) == EBADF) {

/* Code conversion descriptor is invalid. */
return (-1); }

The following example shows how to close the code conversion descriptor without error checking:


(void) kiconv_close(cd);

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

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Committed

iconv(3C), iconv_close(3C), iconv_open(3C), u8_strcmp(3C), u8_textprep_str(3C), u8_validate(3C), uconv_u16tou32(3C), uconv_u16tou8(3C), uconv_u32tou16(3C), uconv_u32tou8(3C), uconv_u8tou16(3C), uconv_u8tou32(3C), attributes(7), kiconv(9F), kiconv_open(9F), kiconvstr(9F), u8_strcmp(9F), u8_textprep_str(9F), u8_validate(9F), uconv_u16tou32(9F), uconv_u16tou8(9F), uconv_u32tou16(9F), uconv_u32tou8(9F), uconv_u8tou16(9F), uconv_u8tou32(9F)

The Unicode Standard

http://www.unicode.org/standard/standard.html

October 16, 2007 OmniOS