UnicodeEQ, UnicodeNE, UnicodeLT, UnicodeLE, UnicodeGE and UnicodeGT (Unicode functions)

Compare unicode strings (Unicode class)

[Introduced in Sirius Mods 7.9]

These Unicode comparison methods perform the named comparison operation between their Unicode string method objects and the method argument values. The methods are useful whenever you need to do comparisons and ordinary EBCDIC string comparisons are not sufficient, say where you may be working with characters that are not translatable to EBCDIC.

Syntax (same for UnicodeNE, UnicodeLT, UnicodeLE, UnicodeGE, and UnicodeGT)

%number = unicode:UnicodeEQ( comparand)

Syntax terms

%number	A number that indicates the success or failure of the indicated User Language comparison: a value of 1 is returned if the stated relation between the unicode value and the comparand value is true; otherwise, 0 is returned.
unicode	A Unicode string.
comparand	The Unicode value that is being compared to the method object, unicode. The method name indicates the type of comparison.

Usage notes

• Unicode comparisons might be useful if you want to use ASCII/Unicode ordering of string values (numbers < uppercase < lowercase).

Examples

The following comparison succeeds:

if %dessert:unicodeEq('Apple &pi;':u) then ...

However, the following comparison does not:

if %dessert eq 'Apple &pi;':u

In this last case, Model 204 will try to convert the Unicode pi character to EBCDIC, and that operation will fail.

See also

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods