Caché ObjectScript Reference
$ZCRC
[Back] [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Checksum function.
Synopsis
$ZCRC(string,mode,expression)
Parameters
string A string on which a checksum operation is performed.
mode An integer code specifying the checksum mode to use.
expression Optional — The initial "seed" value, specified as an integer. If omitted, defaults to zero (0).
Description
$ZCRC performs a cyclic redundancy check on string and returns an integer checksum value. The value returned by $ZCRC depends on the parameters you use.
Parameters
string
A byte string. Can be specified as a value, a variable, or an expression. Only use a byte string or you will receive a <FUNCTION> error.
mode
The checksum algorithm to use. All checksum modes can be used with 8-bit (ASCII) or 16-bit Unicode (wide) characters. Legal values for mode are:
Mode Computes
0 An 8-bit byte sum. Simply sums the ASCII values of the characters in the string. Thus $ZCRC(2,0)=50, $ZCRC(22,0)=100, $ZCRC(23,0)=101, and $ZCRC(32,0)=101.
1 An 8-bit XOR of the bytes
2 A 16-bit DataTree CRC-CCITT
3 A 16-bit DataTree CRC-16
4 A 16-bit CRC for XMODEM protocols
5 A correct 16-bit CRC-CCITT
6 A correct 16-bit CRC-16
7 A correct 32-bit CRC-32. This corresponds to the cksum utility algorithm 3 on OS X, and the CRC32 class in the Java utilities package.
Caché in MSM language mode supports mode values 0 and 1. All other mode values result in a <FUNCT> error.
expression
An argument that is an initial "seed" value. $ZCRC adds expression to the checksum generated for string. This allows you to run $ZCRC calculations on multiple strings sequentially and obtain the save checksum value as if you had concatenated those strings and run $ZCRC on the resulting string.
Examples
The following example uses mode=0 on strings containing the letters A, B, and C and in each case returns the checksum 198:
  WRITE $ZCRC("ABC",0),!
  WRITE $ZCRC("CAB",0),!
  WRITE $ZCRC("BCA",0),!
 
The checksum is derived as follows:
  WRITE $ASCII("A")+$ASCII("B")+$ASCII("C")  /* 65+66+67 = 198 */
 
The following example shows the values returned by each mode for the string “ABC”:
  FOR i=0:1:7 {
     WRITE !,"mode ",i,"=",$ZCRC("ABC",i)
  }
 
See Also