ec_converter_open

ec_converter_open — open a converter

#include "misc/converter.h"

| ec_converter * **ec_converter_open** ( | fromcode, |   | |   | tocode, |   | |   | status); |   |

const char * <var class="pdparam">fromcode</var>; const char * <var class="pdparam">tocode</var>; int * <var class="pdparam">status</var>;

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.

Parameters

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.