![]() |
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 );
A pointer to a converter object. On return, this reference points to a newly created text converter object.
The text encoding specification for the source text encoding.
The text encoding specification for the destination text encoding.
A result code.
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.
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)