MemoryAddress Type

A variable of type MemoryAddress is used to represent a memory address; that is, a void* pointer as used in C. The primary purpose for this primitive type is to interface with external C and C++ dynamic libraries being used as a parameter or a return type.

When an object with a MemoryAddress value is passed between nodes, it passes the value of the memory address. However, the memory address only has meaning for the node on which it was assigned a non-null value.

The following semantic rules apply to MemoryAddress values.

A MemoryAddress variable can be assigned a null value but not the value zero (0).
A MemoryAddress value can be compared to the null value or to another MemoryAddress value for equality or inequality.
A MemoryAddress value can be assigned to another MemoryAddress variable.
A MemoryAddress value cannot be changed by using an arithmetic operation.

Unlike other primitive types, a corresponding subclass of Array for MemoryAddress values does not exist in the RootSchema. If you require such an array, subclass the Array class in your user schema, selecting MemoryAddress as the membership.

For details about the methods defined in the MemoryAddress primitive type, see "MemoryAddress Methods", in the following subsection. For details about converting primitive types, see "Converting Primitive Types", in Chapter 1 of the JADE Developer’s Reference.