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

CountUnicodeMappings

Counts available mappings that meet the specified matching criteria.

pascal OSStatus CountUnicodeMappings (
                     OptionBits iFilter
                     ConstUnicodeMappingPtr iFindMapping
                     ItemCount *oActualCount);
iFilter
Filter control flags representing the six subfields of the Unicode mapping structure that this function uses to match against in determining which mappings on the system to return to your application. The filter control enumeration, described in Filter Control Flags , define the constants for the subfield's flags and their masks. You can include in the search criteria any of the three text encoding subfields for both the Unicode encoding and the other specified encoding. For any flag not turned on, the subfield value is ignored and the function does not check the corresponding subfield of the mappings on the system.

iFindMapping
A structure of type UnicodeMapping containing the text encodings whose field values are to be matched.

oActualCount
A pointer to a value of type ItemCount. On output, the number of matching mappings found.

function result
A result code. See Text Encoding Conversion Manager Result Codes in the chapter Basic Text Types Reference

DISCUSSION

You can use the function to obtain the count of mappings that meet specified criteria by setting individual filter control flags. You can filter on any of the three text encoding subfields of the Unicode mapping structure's unicodeEncoding specification and on any of the three text encoding subfields of the structure's otherEncoding specification. The iFilter parameter consists of a set of six control flags that you set to identify which of the corresponding six subfields to include in the match count. No filtering is performed on fields for which you do not set the corresponding filter control flag.

SEE ALSO

The function QueryUnicodeMappings

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

Up Previous Next