IUMagIDPString

Test equality of two blocks of unformatted text using

specified 'itl2'

short IUMagIDPString(aPtr, bPtr, aLen, bLen, itl2Handle);

const void *aPtr ; addresses of unformatted ...

const void *bPtr ; ... text to compare

short aLen ; length of aPtr, in bytes

short bLen ; length of bPtr, in bytes

Handle itl2Handle ; handle to 'itl2' resource

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

IUMagIDPString compares two strings defined by a pointer and character

length for equality in primary ordering only and permits explicit

specification of the 'itl2' resource to be used for string comparison The

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

return value is NOT a Boolean.

aPtr and . . .

bPtr are the addresses of unformatted text to be compared.

aLen is the length, in bytes, of the text pointed to by aPtr

bLen is the length, in bytes, of the text pointed to by bPtr

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

behaves just like IUMagIDString which does not permit explicit

specification of the handle.

Returns: a short; which indicates whether or not the text pointed to by aPtr

and bPtr are equal. The value is the reverse of a normal C

Boolean, one of:

0 aPtr and bPtr are internationally equal.

1 aPtr is NOT equal to bPtr.

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

IUMagIDPString uses the same testing methods as IUEqualPString. 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 IUEqualPString or

which tell you which string is greater. For a simple case-sensitive, raw

ASCII equality test of pascal-style strings, use EqualString.

Referenced by (8):