Carbon


TECCountAvailableTextEncodings

Header: TextEncodingConverter.h Carbon status: Supported

Counts and returns the number of text encodings currently configured in the Text Encoding Converter.

OSStatus TECCountAvailableTextEncodings (
    ItemCount *numberEncodings
);
Parameter descriptions
numberEncodings

On return, a pointer to the number of currently supported text encodings. You use this value to determine the array size for a parameter of the TECGetAvailableTextEncodings function.

function result

A result code.

DISCUSSION

The number of text encodings includes every instance of a text encoding. If different conversion plug-ins support the same text encoding, the text encoding will be counted more than once. For example, the Japanese Encodings plug-in supports Mac OS Japanese, and so does the Unicode Encodings plug-in. Since the TECGetAvailableTextEncodings function ignores duplicate text encoding specifications, TECCountAvailableTextEncodings may return a number greater than the number of array elements needed for the availableEncodings[] parameter.

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)