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

TECCountDirectTextEncodingConversions

Counts and returns the number of direct conversions that the Text Encoding Converter supports in its current configuration.

pascal OSStatus TECCountDirectTextEncodingConversions (
                     ItemCount *numberOfEncodings);
numberOfEncodings
A pointer to a value of type ItemCount. On output, this value indicates the number of direct conversions that the converter is currently configured to support.

function result
A result code. See Text Encoding Conversion Manager Result Codes for a list of possible values. If other than noErr, then one of the text conversion plug-ins encountered an error when polled by the Text Encoding Converter.

DISCUSSION

You use the number that TECCountDirectTextEncodingConversions returns to determine how large to make the array you pass to the function TECGetDirectTextEncodingConversions.

TECCountDirectTextEncodingConversions counts each instance of an available conversion. That is, if different conversion plug-ins support the same direct conversion, this function includes each instance of the direct conversion in its sum. Consequently, the same direct conversion may be counted more than once. Because the TECGetDirectTextEncodingConversions function does not return duplicate direct conversions, TECCountDirectTextEncodingConversions may return a number greater than the number of array elements required.

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

Up Previous Next