MPE/iX Intrinsics Reference Manual (32650-90905)

514 Chapter9
Command Definitions (MAIL-PUTJCW)
NLCOLLATE
NLCOLLATE
NM and CM callable.
Collates two character strings according to the specified language collating sequence and
determines a lexical ordering.
Syntax
CA CA I16V I16
NLCOLLATE(
buffer1,buffer2,bufferlength,result,
I16V U16A U16A
langnum,error , collseq );
Parameters
buffer1 character array (required)
Passes the first character string to be collated.
buffer2 character array (required)
Passes the second character string to be collated.
bufferlength 16-bit signed integer by value (required)
Passes the length (in bytes) of
buffer1 and buffer2 .
result 16-bit signed integer by reference (required)
Returns the result of the collated character strings (
buffer1 and
buffer2 ):
Value Meaning
0
buffer1 collates equal to buffer2
-1 buffer1 collates before buffer2
1 buffer1 collates after buffer2
The result is 0 if a nonzero error is returned.
langnum 16-bit signed integer by value (required)
Contains the language ID number, specifying the collating sequence to be
used.
error 16-bit unsigned integer array (required)
Returns two elements: the first element is the error number; the second
element is reserved and always returns 0. The possible error number
values are:
Value Meaning
0
Successful