TECCreateOneToManyConverter
Determines a conversion path for the source encoding anddestinations encodings you specify, creates a text encoding converterobject, and returns a reference to it.
Declaration
OSStatus TECCreateOneToManyConverter(TECObjectRef *newEncodingConverter, TextEncoding inputEncoding, ItemCount numOutputEncodings, const TextEncoding outputEncodings[]);Parameters
- newEncodingConverter:
A pointer to a converter object. On return, this points to a 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
outputEncodingarray. - outputEncodings:
An ordered array of text encoding specifications for the destination text encodings.
Return Value
A resultcode. See Result Codes.
Discussion
You use this converter object reference with conversion functionssuch as TECConvertTextToMultipleEncodings.The converter object describes the source, destination, and intermediateencodings; state information; and references to required plug-ins.
To remove a converter object, you must call the function TECDisposeConverter.