![]() |
TECCreateOneToManyConverter |
||||
Header: | TextEncodingConverter.h | Carbon status: | Supported | |
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.
OSStatus TECCreateOneToManyConverter ( TECObjectRef *newEncodingConverter, TextEncoding inputEncoding, ItemCount numOutputEncodings, TextEncoding outputEncodings[] );
A pointer to a converter object. On return, this points to a newly created one-to-many converter object.
The text encoding specification for the source text encoding.
The number of text encoding specifications in the outputEncoding array.
An ordered array of text encoding specifications for the destination text encodings.
A result code.
You use this converter object reference with conversion functions such as TECConvertTextToMultipleEncodings. The 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.
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)