Platform Package reference: Function EwCompString()

Description of the function EwCompString() available in all Platform Packages for C compatible target systems. This function is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.

Declaration

XInt32 EwCompString( XString aString1, XString aString2 )

Parameters

aString1

Pointer to the first wide-character (16-bit per character) string to be compared.

aString2

Pointer to the second wide-character (16-bit per character) string to be compared.

Discussion

The function EwCompString() compares aString1 and aString2 lexicographically and returns a value indicating their relationship. If aString1 is identical to aString2 the function returns 0 (zero). If aString1 is less than aString2 the function returns -1. If aString1 is greater than aString2 the function returns +1.