CCmpB

Performs a block comparison of two memory areas (bytes).

Thread Context:Non-Blocking

Syntax

    LONG CCmpB (
       BYTE  *address0,
       BYTE  *address1,
       LONG   count);

Parameters

address0
(IN) Address of the first block of memory to be compared.
address1
(IN) Address of the second block of memory to be compared.
count
(IN) Number of BYTEs to be compared.

Return Values

The following table lists return values and descriptions.

-1

The specified number of BYTEs match.

Index of the first unmatched BYTE pair

Remarks

CCmpB compares two memory blocks BYTE for BYTE. It returns either a -1 to indicate that the two blocks are identical or the block index showing the position where the blocks first differ.