C Library Functions                                       csconv_open(3)


NAME

     csconv_open - code set conversion allocation function


SYNOPSIS

     #include "csconv.h"

     csconv_t csconv_open_locale(const char * locale,
                                 const char * tocode,
                                 const char * fromcode);
     csconv_t csconv_open(const char * tocode, const char * fromcode);


DESCRIPTION

     The csconv_open_locale() and csconv_open() functions return a
     conversion descriptor that describes a conversion from the code set
     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 csconv(3) function.

     Settings of fromcode and tocode and their permitted combinations
     are defined in csconv.conf and encoding.norm.

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


RETURN VALUES

     Upon successful completion, csconv_open() returns a conversion
     descriptor for use on subsequent calls to csconv().  Otherwise,
     csconv_open() returns (csconv_t)(-1) and sets errno to indicate the
     error.


ERRORS

     See iconv_open(3).


FILES

     /usr/lib/im/csconv/csconv.conf
     /etc/lib/im/csconv/csconv.conf

         CSConv configuration file

     /usr/lib/im/csconv/encoding.norm
     /etc/lib/im/csconv/encoding.norm

         CSConv encoding normalization file


SEE ALSO

     csconv(3), csconv_close(3), csconv.conf(4), encoding.norm(4)
