TECCreateConverterFromPath
Creates a converter object for a specific conversion path—froma source encoding through intermediate encodings to a destinationencoding—and returns a pointer to it.
Declaration
OSStatus TECCreateConverterFromPath(TECObjectRef *newEncodingConverter, const TextEncoding inPath[], ItemCount inEncodings);Parameters
- newEncodingConverter:
A pointer to a converter object reference. On return, the reference points to a newly created text converter object.
- inPath:
An ordered array of text encoding specifications, beginning with the source encoding specification and ending with the destination encoding specification. Each adjacent pair of text encodings must represent a conversion that is supported by the Text Encoding Converter.
- inEncodings:
The number of text encoding specifications in the
inPatharray.
Return Value
A resultcode. See Result Codes.
Discussion
This function is faster than the function TECCreateConverter since it does notneed to search for a conversion path. You can use the TECGetDestinationTextEncodings function to determine each step in the sequence from the sourceto the destination encoding.
To remove a converter object, you must call the function TECDisposeConverter.