Carbon


TECGetAvailableTextEncodings

Header: TextEncodingConverter.h Carbon status: Supported

Returns the text encoding specifications currently configured in the Text Encoding Converter.

OSStatus TECGetAvailableTextEncodings (
    TextEncoding availableEncodings[], 
    ItemCount maxAvailableEncodings, 
    ItemCount *actualAvailableEncodings
);
Parameter descriptions
availableEncodings

On return, an array of text encoding specifications. You should use the TECCountAvailableTextEncodings function to determine what size array to allocate.

maxAvailableEncodings

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

actualAvailableEncodings

On return, a pointer to the number of text encodings returned in the availableEncodings array.

function result

A result code.

DISCUSSION

This function ignores duplicate text encoding specifications. If you used the TECCountAvailableTextEncodings function to determine the size of the availableEncodings[] array, the number of encodings may be fewer than the number of array elements, because TECCountAvailableTextEncodings includes duplicate text encodings in its count.

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)