1kiconv_close(9F)         Kernel Functions for Drivers         kiconv_close(9F)
2
3
4

NAME

6       kiconv_close - code conversion descriptor deallocation function
7

SYNOPSIS

9       #include <sys/errno.h>
10       #include <sys/sunddi.h>
11
12
13
14       int kiconv_close(kiconv_t cd);
15
16

INTERFACE LEVEL

18       Solaris DDI specific (Solaris DDI).
19

PARAMETERS

21       cd    Code conversion descriptor to be deallocated.
22
23

DESCRIPTION

25       The  kiconv_close()  function  deallocates the conversion descriptor cd
26       and all other associated resources allocated by the kiconv_open() func‐
27       tion.
28

RETURN VALUES

30       Upon  successful  completion,  kiconv_close()  returns 0; otherwise, it
31       returns the following errno value to indicate the error:
32
33       EBADF    The code conversion descriptor is invalid.
34
35

CONTEXT

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

EXAMPLES

40       Example 1 Closing the Code Conversion
41
42
43       The following example shows how to close the code conversion descriptor
44       with error checking:
45
46
47         if (kiconv_close(cd) == EBADF) {
48                  /* Code conversion descriptor is invalid. */
49                  return (-1);
50         }
51
52
53
54       The following example shows how to close the code conversion descriptor
55       without error checking:
56
57
58         (void) kiconv_close(cd);
59
60

ATTRIBUTES

62       See attributes(5) for descriptions of the following attributes:
63
64
65
66
67       ┌─────────────────────────────┬─────────────────────────────┐
68       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
69       ├─────────────────────────────┼─────────────────────────────┤
70       │Interface Stability          │Committed                    │
71       └─────────────────────────────┴─────────────────────────────┘
72

SEE ALSO

74       iconv(3C),     iconv_close(3C),     iconv_open(3C),      u8_strcmp(3C),
75       u8_textprep_str(3C),        u8_validate(3C),        uconv_u16tou32(3C),
76       uconv_u16tou8(3C),        uconv_u32tou16(3C),        uconv_u32tou8(3C),
77       uconv_u8tou16(3C), uconv_u8tou32(3C), attributes(5), kiconv(9F), kicon‐
78       vstr(9F), kiconv_open(9F), u8_strcmp(9F), u8_textprep_str(9F), u8_vali‐
79       date(9F),  uconv_u16tou32(9F),  uconv_u16tou8(9F),  uconv_u32tou16(9F),
80       uconv_u32tou8(9F), uconv_u8tou16(9F), uconv_u8tou32(9F)
81
82
83       The Unicode Standard
84
85
86       http://www.unicode.org/standard/standard.html
87
88
89
90SunOS 5.11                        16 Oct 2007                 kiconv_close(9F)
Impressum