0LASubrTextUnicodeComp < Main

Tags: view all tags
---+ .TEXT UNICODE COMP

This subroutine compares 2 Unicode fields. Added in 6.0.0

<br />%TOC%
---++ Usage
<pre>      PASS         &lt;result&gt;                   FIELD            SHARE? Y
      PASS         &lt;first_string&gt;             FIELD            SHARE? N
      PASS         &lt;second_string&gt;            FIELD            SHARE? N
      GOSUB    --- .TEXT UNICODE COMP
      *        Check for errors
      IF       --- .TEXT UNICODE COMP         NE
</pre>

---++ Description

This subroutine will do a case insenstive comparison of two Unicode fields and return a result. All parameters are required. If any required parameters are missing, the subroutine will CANCEL.

&lt;result&gt; is a numeric value returned. If a positive number, then &lt;first_string&gt; is greater than &lt;second_string&gt;, if negative then &lt;second_string&gt; is greater than &lt;first_string&gt; and if zero the strings are equal. The comparison is done using Unicode collating sequences. The larger (or smaller) the number, the greater the 'difference'. For example, comparing 'AAA' to 'BBB' results in -1, while comparing 'AAA' to 'zzz' results in -25.

&lt;first_string&gt; is the first string to compare (Required).

&lt;second_string&gt; is the second string to compare (Required).

Note: This subroutine is designed to operate on Alpha, Text, and Token fields only. The returned results are undefined if you specify any other type of field.
---++ Comments

<br />%COMMENT%

-- %USERSIG{JeanNeron - 2017-11-02}%
Topic revision: r3 - 2023-04-10 - BrianRyan