Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Up Previous Next 

PATH Mac OS 8 and 9 Developer Documentation > Text Encoding Conversion Manager
Programming With the Text Encoding Conversion Manager

TECCreateOneToManyConverter

Creates a converter object that can handle conversion from one source encoding to multiple destination encodings.

pascal OSStatus TECCreateOneToManyConverter(
                     TECObjectRef *newEncodingConverter,
                     TextEncoding inputEncoding,
                     ItemCount numOutputEncodings,
                     const TextEncoding outputEncodings[]);
newEncodingConverter
A pointer to a converter object. On return this points to the newly created one-to-many converter object.

inputEncoding
The text encoding specification for the source text encoding.

numOutputEncodings
The number of text encoding specifications in the outputEncoding array.

outputEncodings[]
An ordered array of text encoding specifications for the destination text encodings.

function result
A result code. See Text Encoding Conversion Manager Result Codes for a list of possible values. If this function returns a result code other than NoErr, then it did not successfully create the converter object reference. If the current configuration of the converter does not support the source encoding or any of the destination encodings, the function returns KTextUnsupportedEncodingErr.

DISCUSSION

The TECCreateOneToManyConverter function determines a conversion path for the source encoding and destinations encodings you specify, creates a text encoding converter object, and returns a reference to it. You use this converter object reference with conversion functions such as TECConvertTextToMultipleEncodings. This converter object describes the source, destination, and intermediate encodings; state information; and references to required plug-ins.

To remove a converter object, you must call the function TECDisposeConverter.

SEE ALSO

The function TECFlushText

© 1999 Apple Computer, Inc. – (Last Updated 13 Dec 99)

Up Previous Next