Standard C Library Functions                       iconvopen(3C)



NAME
     iconvopen - code conversion allocation function

SYNOPSIS
     #include 

     iconvt iconvopen(const char *tocode, const char *fromcode);


DESCRIPTION
     The iconvopen() function returns  a  conversion  descriptor
     that  describes  a  conversion from the codeset specified by
     the string pointed  to  by  the  fromcode  argument  to  the
     codeset  specified  by  the  string pointed to by the tocode
     argument.  For  state-dependent  encodings,  the  conversion
     descriptor  will  be  in   a codeset-dependent initial shift
     state, ready for immediate use with the  iconv(3C) function.


     Settings of fromcode and tocode and their permitted combina-
     tions are implementation-dependent.


     The iconvopen() function supports the alias of the encoding
     name  specified  in tocode and fromcode.  The alias table of
     the   encoding   name   is    described    in    the    file
     /usr/lib/iconv/alias. See alias(4).


     A conversion descriptor remains valid  in  a  process  until
     that process closes it.


     For  examples  using   the    iconvopen()   function,   see
     iconv(3C).

RETURN VALUES
     Upon successful completion  iconvopen() returns  a  conver-
     sion  descriptor  for  use  on subsequent calls to  iconv().
     Otherwise, iconvopen() returns (iconvt) -1 and sets  errno
     to indicate the error.

ERORS
     The  iconvopen function may fail if:

     EMFILE    {OPENMAX} files descriptors are currently open in
               the calling process.


     ENFILE    Too many files are currently open in the system.





SunOS 5.11           Last change: 2 Oct 2001                    1






Standard C Library Functions                       iconvopen(3C)



     ENOMEM    Insufficient storage space is available.


     EINVAL    The conversion specified by fromcode and tocode is
               not supported by the implementation.


FILES
     /usr/lib/iconv/alias    alias table  file  of  the  encoding
                             name


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     exec(2), iconv(3C), iconvclose(3C),  malloc(3C),  alias(4),
     attributes(5)

NOTES
     The iconvopen() function uses malloc(3C) to allocate  space
     for internal buffer areas. iconvopen() may fail if there is
     insufficient storage space to accommodate these buffers.


     Portable applications must assume that  conversion  descrip-
     tors are not valid after a call to one of the exec functions
     (see exec(2)).















SunOS 5.11           Last change: 2 Oct 2001                    2