com.oracle.graal.word

Interface Pointer

All Superinterfaces:

ComparableWord, PointerBase, TrustedInterface, Unsigned, WordBase

All Known Implementing Classes:

HostedWord, Word

public interface Pointer
extends Unsigned, PointerBase

Lowest-level memory access of native C memory. These methods access the raw memory without any null checks, read- or write barriers. Even when the VM uses compressed pointers, then readObject and writeObject methods access uncompressed pointers.

Do not use these methods to access Java objects, i.e., do not use Word.fromObject(obj).readXxx(). Instead, use ObjectAccess or BarrieredAccess to access Java objects.

Method Summary

Modifier and Type	Method and Description
Pointer	add(int val) Returns a Unsigned whose value is (this + val).
Pointer	add(Unsigned val) Returns a Unsigned whose value is (this + val).
Pointer	and(int val) Returns a Unsigned whose value is (this & val).
Pointer	and(Unsigned val) Returns a Unsigned whose value is (this & val).
void	initializeLong(int offset, long val, LocationIdentity locationIdentity) Initializes the memory at address (this + offset).
void	initializeLong(WordBase offset, long val, LocationIdentity locationIdentity) Initializes the memory at address (this + offset).
Pointer	or(int val) Returns a Unsigned whose value is (this | val).
Pointer	or(Unsigned val) Returns a Unsigned whose value is (this | val).
byte	readByte(int offset) Reads the memory at address (this + offset).
byte	readByte(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
byte	readByte(WordBase offset) Reads the memory at address (this + offset).
byte	readByte(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
char	readChar(int offset) Reads the memory at address (this + offset).
char	readChar(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
char	readChar(WordBase offset) Reads the memory at address (this + offset).
char	readChar(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
double	readDouble(int offset) Reads the memory at address (this + offset).
double	readDouble(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
double	readDouble(WordBase offset) Reads the memory at address (this + offset).
double	readDouble(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
float	readFloat(int offset) Reads the memory at address (this + offset).
float	readFloat(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
float	readFloat(WordBase offset) Reads the memory at address (this + offset).
float	readFloat(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
int	readInt(int offset) Reads the memory at address (this + offset).
int	readInt(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
int	readInt(WordBase offset) Reads the memory at address (this + offset).
int	readInt(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
long	readLong(int offset) Reads the memory at address (this + offset).
long	readLong(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
long	readLong(WordBase offset) Reads the memory at address (this + offset).
long	readLong(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
Object	readObject(int offset) Reads the memory at address (this + offset).
Object	readObject(int offset, HeapAccess.BarrierType barrierType) Reads the memory at address (this + offset).
Object	readObject(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
Object	readObject(WordBase offset) Reads the memory at address (this + offset).
Object	readObject(WordBase offset, HeapAccess.BarrierType barrierType) Reads the memory at address (this + offset).
Object	readObject(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
short	readShort(int offset) Reads the memory at address (this + offset).
short	readShort(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
short	readShort(WordBase offset) Reads the memory at address (this + offset).
short	readShort(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
Word	readWord(int offset) Reads the memory at address (this + offset).
Word	readWord(int offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
Word	readWord(WordBase offset) Reads the memory at address (this + offset).
Word	readWord(WordBase offset, LocationIdentity locationIdentity) Reads the memory at address (this + offset).
Pointer	subtract(int val) Returns a Unsigned whose value is (this - val).
Pointer	subtract(Unsigned val) Returns a Unsigned whose value is (this - val).
Object	toObject() Unsafe conversion of this Pointer to a Java language object.
void	writeByte(int offset, byte val) Writes the memory at address (this + offset).
void	writeByte(int offset, byte val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeByte(WordBase offset, byte val) Writes the memory at address (this + offset).
void	writeByte(WordBase offset, byte val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeChar(int offset, char val) Writes the memory at address (this + offset).
void	writeChar(int offset, char val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeChar(WordBase offset, char val) Writes the memory at address (this + offset).
void	writeChar(WordBase offset, char val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeDouble(int offset, double val) Writes the memory at address (this + offset).
void	writeDouble(int offset, double val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeDouble(WordBase offset, double val) Writes the memory at address (this + offset).
void	writeDouble(WordBase offset, double val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeFloat(int offset, float val) Writes the memory at address (this + offset).
void	writeFloat(int offset, float val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeFloat(WordBase offset, float val) Writes the memory at address (this + offset).
void	writeFloat(WordBase offset, float val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeInt(int offset, int val) Writes the memory at address (this + offset).
void	writeInt(int offset, int val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeInt(WordBase offset, int val) Writes the memory at address (this + offset).
void	writeInt(WordBase offset, int val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeLong(int offset, long val) Writes the memory at address (this + offset).
void	writeLong(int offset, long val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeLong(WordBase offset, long val) Writes the memory at address (this + offset).
void	writeLong(WordBase offset, long val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeObject(int offset, Object val) Writes the memory at address (this + offset).
void	writeObject(int offset, Object val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeObject(WordBase offset, Object val) Writes the memory at address (this + offset).
void	writeObject(WordBase offset, Object val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeShort(int offset, short val) Writes the memory at address (this + offset).
void	writeShort(int offset, short val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeShort(WordBase offset, short val) Writes the memory at address (this + offset).
void	writeShort(WordBase offset, short val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeWord(int offset, WordBase val) Writes the memory at address (this + offset).
void	writeWord(int offset, WordBase val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).
void	writeWord(WordBase offset, WordBase val) Writes the memory at address (this + offset).
void	writeWord(WordBase offset, WordBase val, LocationIdentity locationIdentity) Writes the memory at address (this + offset).

Methods inherited from interface com.oracle.graal.word.Unsigned

aboveOrEqual, aboveOrEqual, aboveThan, aboveThan, belowOrEqual, belowOrEqual, belowThan, belowThan, equal, equal, multiply, multiply, not, notEqual, notEqual, shiftLeft, shiftLeft, unsignedDivide, unsignedDivide, unsignedRemainder, unsignedRemainder, unsignedShiftRight, unsignedShiftRight, xor, xor

Methods inherited from interface com.oracle.graal.word.ComparableWord

equal, notEqual

Methods inherited from interface com.oracle.graal.word.WordBase

rawValue

Method Detail

toObject

Object toObject()

Unsafe conversion of this Pointer to a Java language object. No correctness checks or type checks are performed. The caller must ensure that the Pointer contains a valid Java object that can i.e., processed by the garbage collector.

Returns:

this Pointer cast to Object.

readByte

byte readByte(WordBase offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readChar

char readChar(WordBase offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readShort

short readShort(WordBase offset,
                LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readInt

int readInt(WordBase offset,
            LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readLong

long readLong(WordBase offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readFloat

float readFloat(WordBase offset,
                LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readDouble

double readDouble(WordBase offset,
                  LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readWord

Word readWord(WordBase offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readObject

Object readObject(WordBase offset,
                  LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readByte

byte readByte(int offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readChar

char readChar(int offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readShort

short readShort(int offset,
                LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readInt

int readInt(int offset,
            LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readLong

long readLong(int offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readFloat

float readFloat(int offset,
                LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readDouble

double readDouble(int offset,
                  LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readWord

Word readWord(int offset,
              LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

readObject

Object readObject(int offset,
                  LocationIdentity locationIdentity)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the read

Returns:

the result of the memory access

writeByte

void writeByte(WordBase offset,
               byte val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeChar

void writeChar(WordBase offset,
               char val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeShort

void writeShort(WordBase offset,
                short val,
                LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeInt

void writeInt(WordBase offset,
              int val,
              LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeLong

void writeLong(WordBase offset,
               long val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeFloat

void writeFloat(WordBase offset,
                float val,
                LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeDouble

void writeDouble(WordBase offset,
                 double val,
                 LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeWord

void writeWord(WordBase offset,
               WordBase val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

initializeLong

void initializeLong(WordBase offset,
                    long val,
                    LocationIdentity locationIdentity)

Initializes the memory at address (this + offset). Both the base address and offset are in bytes. The memory must be uninitialized or zero prior to this operation.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeObject

void writeObject(WordBase offset,
                 Object val,
                 LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeByte

void writeByte(int offset,
               byte val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeChar

void writeChar(int offset,
               char val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeShort

void writeShort(int offset,
                short val,
                LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeInt

void writeInt(int offset,
              int val,
              LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeLong

void writeLong(int offset,
               long val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeFloat

void writeFloat(int offset,
                float val,
                LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeDouble

void writeDouble(int offset,
                 double val,
                 LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeWord

void writeWord(int offset,
               WordBase val,
               LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

initializeLong

void initializeLong(int offset,
                    long val,
                    LocationIdentity locationIdentity)

Initializes the memory at address (this + offset). Both the base address and offset are in bytes. The memory must be uninitialized or zero prior to this operation.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

writeObject

void writeObject(int offset,
                 Object val,
                 LocationIdentity locationIdentity)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

locationIdentity - the identity of the write

val - the value to be written to memory

readByte

byte readByte(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readChar

char readChar(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readShort

short readShort(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readInt

int readInt(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readLong

long readLong(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readFloat

float readFloat(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readDouble

double readDouble(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readWord

Word readWord(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readObject

Object readObject(WordBase offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readObject

Object readObject(WordBase offset,
                  HeapAccess.BarrierType barrierType)

Reads the memory at address (this + offset). This access will decompress the oop if the VM uses compressed oops, and it can be parameterized to allow read barriers (G1 referent field).

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

barrierType - the type of the read barrier to be added

Returns:

the result of the memory access

readByte

byte readByte(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readChar

char readChar(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readShort

short readShort(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readInt

int readInt(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readLong

long readLong(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readFloat

float readFloat(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readDouble

double readDouble(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readWord

Word readWord(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readObject

Object readObject(int offset)

Reads the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

Returns:

the result of the memory access

readObject

Object readObject(int offset,
                  HeapAccess.BarrierType barrierType)

Reads the memory at address (this + offset). This access will decompress the oop if the VM uses compressed oops, and it can be parameterized to allow read barriers (G1 referent field).

Parameters:

offset - the signed offset for the memory access

barrierType - the type of the read barrier to be added

Returns:

the result of the memory access

writeByte

void writeByte(WordBase offset,
               byte val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeChar

void writeChar(WordBase offset,
               char val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeShort

void writeShort(WordBase offset,
                short val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeInt

void writeInt(WordBase offset,
              int val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeLong

void writeLong(WordBase offset,
               long val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeFloat

void writeFloat(WordBase offset,
                float val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeDouble

void writeDouble(WordBase offset,
                 double val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeWord

void writeWord(WordBase offset,
               WordBase val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeObject

void writeObject(WordBase offset,
                 Object val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

The offset is always treated as a Signed value. However, the static type is WordBase to avoid the frequent casts to of Unsigned values (where the caller knows that the highest-order bit of the unsigned value is never used).

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeByte

void writeByte(int offset,
               byte val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeChar

void writeChar(int offset,
               char val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeShort

void writeShort(int offset,
                short val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeInt

void writeInt(int offset,
              int val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeLong

void writeLong(int offset,
               long val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeFloat

void writeFloat(int offset,
                float val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeDouble

void writeDouble(int offset,
                 double val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeWord

void writeWord(int offset,
               WordBase val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

writeObject

void writeObject(int offset,
                 Object val)

Writes the memory at address (this + offset). Both the base address and offset are in bytes.

Parameters:

offset - the signed offset for the memory access

val - the value to be written to memory

add

Pointer add(Unsigned val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this + val).

Specified by:

add in interface Unsigned

Parameters:

val - value to be added to this Unsigned.

Returns:

this + val

add

Pointer add(int val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this + val).

Note that the right operand is a signed value, while the operation is performed unsigned. Therefore, the result is only well-defined for positive right operands.

Specified by:

add in interface Unsigned

Parameters:

val - value to be added to this Unsigned.

Returns:

this + val

subtract

Pointer subtract(Unsigned val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this - val).

Specified by:

subtract in interface Unsigned

Parameters:

val - value to be subtracted from this Unsigned.

Returns:

this - val

subtract

Pointer subtract(int val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this - val).

Note that the right operand is a signed value, while the operation is performed unsigned. Therefore, the result is only well-defined for positive right operands.

Specified by:

subtract in interface Unsigned

Parameters:

val - value to be subtracted from this Unsigned.

Returns:

this - val

and

Pointer and(Unsigned val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this & val).

Specified by:

and in interface Unsigned

Parameters:

val - value to be AND'ed with this Unsigned.

Returns:

this & val

and

Pointer and(int val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this & val).

Note that the right operand is a signed value, while the operation is performed unsigned. Therefore, the result is only well-defined for positive right operands.

Specified by:

and in interface Unsigned

Parameters:

val - value to be AND'ed with this Unsigned.

Returns:

this & val

or

Pointer or(Unsigned val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this | val).

Specified by:

or in interface Unsigned

Parameters:

val - value to be OR'ed with this Unsigned.

Returns:

this | val

or

Pointer or(int val)

Description copied from interface: Unsigned

Returns a Unsigned whose value is (this | val).

Note that the right operand is a signed value, while the operation is performed unsigned. Therefore, the result is only well-defined for positive right operands.

Specified by:

or in interface Unsigned

Parameters:

val - value to be OR'ed with this Unsigned.

Returns:

this | val