IUMagIDString

Test equality of two blocks of unformatted text

short IUMagIDString(ptrA, ptrB, lenA, lenB );

Ptr strA ; addresses of unformatted ...

Ptr strB ; ... text to compare

short lenA ; length of strA, in bytes

short lenB ; length of strB, in bytes

returns 0 if (a==b); 1 if (a != b)

IUMagIDString checks for equality of two blocks of text. The comparison is

case-insensitive and ignores diacritical marks. Note that the return value is

NOT a Boolean.

strA and . . .

strB are the addresses of unformatted text to be compared.

lenA is the length, in bytes, of strA.

lenB is the length, in bytes, of strB.

Returns: a signed integer; it identifies whether or not strA and strB are equal.

The value is the reverse of a normal C Boolean; one of:

0 strA and strB are internationally equal.

1 strA is NOT equal to strB.

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

IUMagIDString uses the same testing methods as IUEqualString. It

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 pascal-style strings, use IUEqualString. For sorting

use IUMagString, which tells you which string is greater. For a simple

case-sensitive, raw ASCII equality test of pascal-style strings, use

Referenced by (8):