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



TECGetAvailableTextEncodings

Returns the text encoding specifications the converter is currently configured to handle.

pascal OSStatus TECGetAvailableTextEncodings (
                     TextEncoding availableEncodings[],
                     ItemCount maxAvailableEncodings,
                     ItemCount *actualAvailableEncodings);
availableEncodings[]
An array of text encoding specifications. On output, the TECGetAvailableTextEncodings function fills the array with the specifications for the text encodings the Text Encoding Converter currently supports. To determine how large an array to allocate, use the function TECCountAvailableTextEncodings.

maxAvailableEncodings
The number of text encoding specifications the availableEncodings array can contain.

actualAvailableEncodings
A pointer to a value of type ItemCount. On output, this value indicates the number of text encodings the function returned in the availableEncodings array.

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

The TECGetAvailableTextEncodings function returns the text encoding specifications in the array you pass to the function as the availableEncodings parameter, eliminating any duplicate information in the process. Consequently, the number of encodings TECGetAvailableTextEncodings returns in the available encodings array may be fewer than the number of elements you allocated for the array based on your call to TECCountAvailableTextEncodings. TECGetAvailableTextEncodings tells you the number of specifications it returns in the actualAvailableEncodings parameter.


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

Up Previous Next