CBL_NLS_COMPARE
Compares two strings.
Syntax:
call "CBL_NLS_COMPARE" using string1
string2
by value string1-length
by value string2-length
by reference result-byte
returning status-code
Parameters:
|
Using call prototype (see Library Routines - Key) |
Picture (32-bit systems) |
string1 |
pic x(n). |
pic x(n). |
string2 |
pic x(n). |
pic x(n). |
string1-length |
cblt-os-size |
pic x(4) comp-5. |
string2-length |
cblt-os-size |
pic x(4) comp-5. |
result-byte |
cblt-sx1-comp5 |
pic s9 comp-5. |
status-code |
See Library Routines - Key |
On Entry:
string1 |
The first string. |
string2 |
The second string. |
string1-length |
Length of the first string. |
string2-length |
Length of the second string. |
On Exit:
result-byte |
Result of the comparison:
0 |
The two strings are the same |
-1 |
string1 < string2 |
+1 |
string1 > string2 | |
status-code |
Indicates whether the routine was successful:
0 |
Success |
105 |
Memory allocation error | |
See Also: