Carbon


TECCreateConverter

Header: TextEncodingConverter.h Carbon status: Supported

Determines a conversion path for a source and destination encoding, then creates a text encoding converter object and returns a pointer to it.

OSStatus TECCreateConverter (
    TECObjectRef *newEncodingConverter, 
    TextEncoding inputEncoding, 
    TextEncoding outputEncoding
);
Parameter descriptions
newEncodingConverter

A pointer to a converter object. On return, this reference points to a newly created text converter object.

inputEncoding

The text encoding specification for the source text encoding.

outputEncoding

The text encoding specification for the destination text encoding.

function result

A result code.

DISCUSSION

You use this converter object reference with conversion functions such as TECConvertText to convert text. This converter object describes the source, destination, and intermediate encodings; state information; and references to required plug-ins.

If the function does not find a direct conversion path, it creates an indirect conversion path. You can use the function TECCreateConverterFromPath to specify an explicit conversion path.

You must use the TECDisposeConverter function to remove a converter object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)