ec_converter_open — open a converter
ec_converter * **ec_converter_open** ( | fromcode, | |
| | tocode, | |
| | status
); | |
This reference page was automatically generated from functions found in the header files in the development branch. The function described here may not exist in generally available versions of Momentum, and may change in behavior when it is generally available. Consult your vendor for definitive advice on the use of this function.
open a converter.
The converter can be used to convert from one encoding to another, optionally applying case folding.
The converter is a fairly low-level streaming capable API that maintains conversion state between chunks of data.
By default, the system iconv(3) routines are used, so the supported encodings are those provided by your system iconv(3) library. You may also load the ICU module in your
ecelerity.conf to increase the number of supported encodings.
In addition, we provide "base64" and "quoted-printable" converters that allow you to convert to and from those transfer encoding schemes.
the encoding used for the input data
the encoding to be used for the output data
returns additional information about the operation of opening the converter.
You must not use a converter from multiple threads; create and destroy them as you need them, and the infrastructure will ensure that this is as efficient as possible.