IUEqualPString

Test equality of two p-strings using specified 'itl2'

short IUEqualPString(aStr, bStr, itl2Handle );

Str255 aStr ; strings to ...

Str255 bStr; ... compare

Handle itl2Handle; handle to 'itl2' resource

returns 0 if equal, 1 if not equal

IUEqualPString compares two high-level language strings for equality in

primary ordering only and permits explicit specification of the 'itl2' resource

to be used for string comparison The comparison is insensitive to character

case and it ignores diacritical marks. Note that the return value is NOT a

aStr and . . .

bStr are the addresses of pascal-style length-prefixed strings to be

compared.

itl2Handle is a handle to an 'itl2' resource. If this handle is NIL, the routine

behaves just like IUEqualString, which does not permit explicit

specification of the handle.

Returns: a short; which indicates or not aStr and bStr are equal. The value is

the reverse of a normal Boolean; one of:

0 aStr and bStr are equal as defined below.

1 aStr is NOT equal to bStr.

Notes: The return value is contrary to C usage of booleans.

IUEqualPString ignores character case and diacritical marks. For

instance,

"Alfred

"alfred

"Ålfred

are all considered to be equal.

If one string is shorter than the other, the function immediately returns a

1 (i.e., not equal).

To test equality of unformatted text (i.e., non-pascal strings), use

IUMagIDPString. For sorting use IUCompPString which tells you

which string is greater. For a faster raw ASCII equality test, use

Referenced by (12):