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

TECDisposeConverter

Disposes of a converter object.

pascal OSStatus TECDisposeConverter (TECObjectRef newEncodingConverter);
newEncodingConverter
A reference to the text encoding converter object to be removed. This can be the reference returned by the function TECCreateConverter, TECCreateConverterFromPath, or TECCreateOneToManyConverter.

function result
A result code. See Text Encoding Conversion Manager Result Codes for a list of possible values.

DISCUSSION

You use TECDisposeConverter to dispose of an encoding converter object and its associated reference when you have finished using it. Do not specify a converter object reference as a parameter to another function after you use TECDisposeConverter to dispose of it.

If you want to reuse the converter object for a different text stream with the same source and destination encoding, you should clear the converter object using the function TECClearConverterContextInfo rather than dispose of it and create the object again.

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

Up Previous Next