Carbon


TECCountWebTextEncodings

Header: TextEncodingConverter.h Carbon status: Supported

Counts and returns the number of currently supported text encodings for a region code.

OSStatus TECCountWebTextEncodings (
    RegionCode locale, 
    ItemCount *numberEncodings
);
Parameter descriptions
locale

A Mac OS region code indicating the locale for which you want to count encodings. A region code designates a combination of language, writing system, and geographic region; the region may not correspond to a particular country (for example, Swiss French or Arabic).

numberEncodings

On return, a pointer to the number of currently supported text encodings for a region code. You should use this number to determine how large to make the array you pass to the TECGetWebTextEncodings function.

function result

A result code.

DISCUSSION

This function counts every instance of the same encoding. That is, if different conversion plug-ins support the same text encoding for a conversion process, the text encoding is counted more than once. Since the TECGetWebTextEncodings function ignores duplicate text encoding specifications, TECCountWebTextEncodings 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)