This module interfaces with the TECkit processor to provide a Perl interface for data conversion.
TECkit is a binary encoding converter designed to handle complex encoding conversions requiring multiple passes over the data and contextual data conversion. TECkit contains its own language and compiler, but these are not written in Perl.
There are two forms of Encode::TECkit (this is probably a bug). The first is a Perl object which passes methods along to the Encode::TECkit XS code. The difference is that the Perl object usually contains two binary Encode::TECkit objects. So, don't go calling XS methods on the pure Perl object (as returned by new).
This creates a new TECkit object. The usual form of the method call is to pass in the filename of the TECkit binary control file to use. In addition, the option: -form may be used to specify which normal form to create when converting to UTF-8. This can take the values: nfc or nfd.
It is possible to get an XS Encode::TECkit object using new(). To get this, use the following required options:-raw
Set this to a non-zero value to get a pure XS object -forward
if set, then mapping of this object is in the direction of forwards as specified in the TECkit binary file. By default this is assumed to by bytes to Unicode. if cleared, then the direction is the opposite (Unicode to bytes). -style
This specifies what form the data should be converted to. The only sensible values are: 1 for bytes and 2 for UTF-8.