compare_memory_blockT_compare_memory_blockCompareMemoryBlockCompareMemoryBlockcompare_memory_block (Operator)
Name
compare_memory_blockT_compare_memory_blockCompareMemoryBlockCompareMemoryBlockcompare_memory_block
— Compare contents of memory blocks regarding equality.
Signature
Description
The operator compare_memory_blockcompare_memory_blockCompareMemoryBlockCompareMemoryBlockCompareMemoryBlockcompare_memory_block
compares the contents of two memory
block tuples and returns the comparison result in IsEqualIsEqualIsEqualIsEqualisEqualis_equal
. Therefore,
each memory block in the tuple MemoryBlocks1MemoryBlocks1MemoryBlocks1MemoryBlocks1memoryBlocks1memory_blocks_1
is compared to the
respective block in the tuple MemoryBlocks2MemoryBlocks2MemoryBlocks2MemoryBlocks2memoryBlocks2memory_blocks_2
with the same index.
IsEqualIsEqualIsEqualIsEqualisEqualis_equal
is set to TRUE if the number of elements of the two tuples
matches and if the length and byte content of each pair of memory blocks
coincides, otherwise to FALSE.
Attention
Note that compare_memory_blockcompare_memory_blockCompareMemoryBlockCompareMemoryBlockCompareMemoryBlockcompare_memory_block
compares the memory blocks regarding
their actual byte content, not their location in memory.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
MemoryBlocks1MemoryBlocks1MemoryBlocks1MemoryBlocks1memoryBlocks1memory_blocks_1
(input_control) memory_block(-array) →
HMemoryBlock, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Tuple of reference memory blocks.
MemoryBlocks2MemoryBlocks2MemoryBlocks2MemoryBlocks2memoryBlocks2memory_blocks_2
(input_control) memory_block(-array) →
HMemoryBlock, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Tuple of test memory blocks.
IsEqualIsEqualIsEqualIsEqualisEqualis_equal
(output_control) integer →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Boolean result value.
Result
The operator compare_memory_blockcompare_memory_blockCompareMemoryBlockCompareMemoryBlockCompareMemoryBlockcompare_memory_block
returns the value 2 (H_MSG_TRUE) if the
passed handles are valid. Otherwise, an exception is raised.
Possible Predecessors
create_memory_block_externcreate_memory_block_externCreateMemoryBlockExternCreateMemoryBlockExternCreateMemoryBlockExterncreate_memory_block_extern
,
create_memory_block_extern_copycreate_memory_block_extern_copyCreateMemoryBlockExternCopyCreateMemoryBlockExternCopyCreateMemoryBlockExternCopycreate_memory_block_extern_copy
,
image_to_memory_blockimage_to_memory_blockImageToMemoryBlockImageToMemoryBlockImageToMemoryBlockimage_to_memory_block
,
read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockReadMemoryBlockread_memory_block
Module
Foundation