Legacy Document

Inside Macintosh: Text /

Chapter 5 - Text Utilities / Text Utilities Reference

Routines / Comparing Strings for Equality

IdenticalText

The IdenticalText function compares two text strings for equality, making use of the string comparison information from a resource that you specify as a parameter. IdenticalText uses only primary sorting order in its comparison.

FUNCTION IdenticalText (aPtr, bPtr: Ptr; aLen, bLen: Integer;
                        itl2Handle: Handle): Integer;

aPtr

A pointer to the first character of the first text string.

bPtr

A pointer to the first character of the second text string.

aLen

The number of bytes in the first text string.

bLen

The number of bytes in the second text string.

itl2Handle

A handle to a string-manipulation ('itl2') resource that contains string comparison information.

DESCRIPTION

IdenticalText returns 0 if the two text strings are equal and 1 if they are not equal. It compares the strings without regard for secondary sorting order, which means that it ignores diacritical marks and does not distinguish between lowercase and uppercase. For example, if the two text strings are 'Rose' and 'rosé', IdenticalText considers them equal and returns 0.

The itl2Handle parameter is used to specify a string-manipulation resource. If the value of this parameter is NIL, IdenticalText makes use of the resource for the current script. The string-manipulation resource includes routines and tables for modifying string comparison and tables for case conversion and stripping of diacritical marks.

Specifying a resource as a parameter is described in the section "Obtaining Resource Information," which begins on page 5-4.

SPECIAL CONSIDERATIONS

IdenticalText may move memory; your application should not call this function at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the IdenticalText function are

Trap macro	Selector
_Pack6	$001C