CFStringCompareWithOptions |
||||
Header: | CFString.h | Carbon status: | Supported | |
Compares a range of the characters in one CFString object with that of another CFString object.
CFComparisonResult CFStringCompareWithOptions ( CFStringRef string1, CFStringRef string2, CFRange rangeToCompare, CFOptionFlags compareOptions );
Pass a reference to the first CFString object to be used in the comparison.
Pass a reference to the second CFString object to be used in the comparison.
Pass a structure of type CFRange that specifies a range of the characters in the first CFString object to be used in the comparison (string1). To use the whole string, pass the range CFRangeMake(0, CFStringGetLength(string1)) or use CFStringCompare.
Pass a bitfield of type CFOptionFlags containing one or more comparison-option flags (OR'd together if multiple) or, if you want no options, pass zero. The options include such features as localized comparison, case-insensitive comparison, and non-literal compariosn.
A constant of type CFComparisonResult that indicates whether the first CFString object is equal to, less than, or greater than the second object.
The CFStringCompare compares a range of the character contents of one CFString object with that of another CFString object. You can affect how the comparison proceeds by specifying one or more option flags. Not all comparison options are currently implemented.
If you want to compare one entire CFString object with another CFString object, use the CFStringCompare function.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)