Kernel Functions for Drivers                     kiconvclose(9F)



NAME
     kiconvclose - code conversion descriptor deallocation func-
     tion

SYNOPSIS
     #include 
     #include 



     int kiconvclose(kiconvt cd);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     cd    Code conversion descriptor to be deallocated.


DESCRIPTION
     The  kiconvclose()  function  deallocates  the   conversion
     descriptor  cd  and all other associated resources allocated
     by the kiconvopen() function.

RETURN VALUES
     Upon successful completion, kiconvclose() returns 0; other-
     wise,  it  returns the following errno value to indicate the
     error:

     EBADF    The code conversion descriptor is invalid.


CONTEXT
     kiconvclose() 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 (kiconvclose(cd) == EBADF) {
                /* Code conversion descriptor is invalid. */
                return (-1);
       }







SunOS 5.11          Last change: 16 Oct 2007                    1






Kernel Functions for Drivers                     kiconvclose(9F)



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


       (void) kiconvclose(cd);


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    


SEE ALSO
     iconv(3C), iconvclose(3C),  iconvopen(3C),  u8strcmp(3C),
     u8textprepstr(3C),   u8validate(3C),  uconvu16tou32(3C),
     uconvu16tou8(3C),  uconvu32tou16(3C),   uconvu32tou8(3C),
     uconvu8tou16(3C),     uconvu8tou32(3C),     attributes(5),
     kiconv(9F), kiconvstr(9F),  kiconvopen(9F),  u8strcmp(9F),
     u8textprepstr(9F),   u8validate(9F),  uconvu16tou32(9F),
     uconvu16tou8(9F),  uconvu32tou16(9F),   uconvu32tou8(9F),
     uconvu8tou16(9F), uconvu8tou32(9F)


     The Unicode Standard


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




















SunOS 5.11          Last change: 16 Oct 2007                    2