Carbon


TECCountDestinationTextEncodings

Header: TextEncodingConverter.h Carbon status: Supported

Counts and returns the number of destination encodings to which a specified source encoding can be converted in one step.

OSStatus TECCountDestinationTextEncodings (
    TextEncoding inputEncoding, 
    ItemCount *numberOfEncodings
);
Parameter descriptions
inputEncoding

The text encoding specification describing the source text.

numberOfEncodings

On return, a pointer to the number of text encodings to which the source encoding can be converted in one step. You should use this to determine how large to make the array you pass to the TECGetDestinationTextEncodings function.

function result

A result code.

DISCUSSION

This function counts every instance of an encoding. If different conversion plug-ins support the same direct text encoding, the direct text encoding is counted more than once.

Since the TECGetDestinationTextEncodings function ignores duplicate text encoding specifications, TECCountDestinationTextEncodings may return a number greater than the number of array elements needed for the destinationEncodings[] 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)