|
|
kiconv_close(9F) Kernel Functions for Drivers kiconv_close(9F) NAME
kiconv_close - code conversion descriptor deallocation function SYNOPSIS
#include <sys/errno.h> #include <sys/sunddi.h> int kiconv_close(kiconv_t cd); INTERFACE LEVEL
Solaris DDI specific (Solaris DDI). PARAMETERS
cd Code conversion descriptor to be deallocated. DESCRIPTION
The kiconv_close() function deallocates the conversion descriptor cd and all other associated resources allocated by the kiconv_open() function. RETURN VALUES
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. CONTEXT
kiconv_close() can be called from user or interrupt context. EXAMPLES
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); ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ SEE ALSO
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(5), kiconv(9F), kiconvstr(9F), kiconv_open(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 SunOS 5.11 16 Oct 2007 kiconv_close(9F)