Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Up Previous Next 

PATH 
Mac OS 8 and 9 Developer Documentation > Text Encoding Conversion Manager
Programming With the Text Encoding Conversion Manager



TECCountWebTextEncodings

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

pascal OSStatus TECCountWebTextEncodings (
                     RegionCode locale,
                     ItemCount *numberEncodings);
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
A pointer to a value of type ItemCount. On output, this value indicates the number of currently supported regional text encodings.

function result
A result code. See Text Encoding Conversion Manager Result Codes for a list of possible values. If other than noErr, then one of the text conversion plug-ins encountered an error when polled by the Text Encoding Converter.

DISCUSSION

The TECCountWebTextEncodings function counts and returns the number of text encodings that you can use to perform conversions for the specified region. This number tells you what size array you must allocate in a parameter of the function TECGetWebTextEncodings. Therefore, you should call this function before you call TECGetWebTextEncodings in order to accommodate the specifications for all of these text encodings.

TECCountWebTextEncodings counts each instance of the same encoding. That is, if different conversion plug-ins support the same text encoding for any of the conversion processes they provide, this function includes each instance of the text encoding in its sum. Consequently, the same text encoding may be counted more than once. For example, the Japanese Encodings plug-in supports Mac OS Japanese and so does the Unicode Encodings plug-in. However, since the TECGetWebTextEncodings function does not return duplicate text encoding specifications, TECCountWebTextEncodings may return a number greater than the number of array elements required.

SEE ALSO

The function TECCountAvailableTextEncodings

The function TECGetAvailableTextEncodings

The function TECGetTextEncodingFromInternetName

The function GetTextEncodingName

The region codes section of "Script Manager" in Inside Macintosh: Text


© 1999 Apple Computer, Inc. – (Last Updated 13 Dec 99)

Up Previous Next