Carbon


TECCountMailTextEncodings

Header: TextEncodingConverter.h Carbon status: Supported

Counts and returns the number of currently supported e-mail encodings for a specified region.

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

A Mac OS region code. 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 e-mail encodings for the region code. You use this number to determine what size array to allocate for a parameter of the TECGetMailTextEncodings 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 TECGetMailTextEncodings function ignores duplicate text encoding specifications, TECCountMailTextEncodings may return a number greater than the number of array elements needed.

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)