![]() |
CompareText |
||||
Header: | StringCompare.h | Carbon status: | Supported | |
Compares two text strings, making use of the string comparison information from a resource that you specify as a parameter.
SInt16 CompareText ( const void *aPtr, const void *bPtr, SInt16 aLen, SInt16 bLen, Handle itl2Handle );
A pointer to the first character of the first text string.
A pointer to the first character of the second text string.
The length, in bytes, of the first text string.
The length, in bytes, of the second text string.
A handle to a string-manipulation ('itl2') resource that contains string comparison information. If the value of this parameter is NULL, CompareText makes use of the resource for the current script. The string-manipulation resource includes functions and tables for modifying string comparison and tables for case conversion and stripping of diacritical marks.
Returns 1 if the first string is less than the second string, 0 if the first string is equal to the second string, and 1 if the first string is greater than the second string.
This function takes both primary and secondary sorting orders into consideration and returns a value that indicates the sorting order of the first string relative to the second string.
CompareText may move memory; your application should not call this function at interrupt time.
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 6/30/2000)