Carbon


TECDisposeConverter

Header: TextEncodingConverter.h Carbon status: Supported

Disposes of a converter object.

OSStatus TECDisposeConverter (
    TECObjectRef newEncodingConverter
);
Parameter descriptions
newEncodingConverter

A reference to the text encoding converter object you want to remove. This can be the reference returned by the TECCreateConverter, TECCreateConverterFromPath, or TECCreateOneToManyConverter functions.

function result

A result code.

DISCUSSION

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 TECClearConverterContextInfo function rather than disposing of it and then creating a new converter object.

AVAILABILITY

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)