Package com.oracle.truffle.api.bytecode

Class LocalRangeAccessor

java.lang.Object

com.oracle.truffle.api.bytecode.LocalRangeAccessor

public final class LocalRangeAccessor
extends Object

Operation parameter that allows an operation to update a contiguous range of locals. This class is intended to be used in combination with the ConstantOperand annotation.

When a local setter range is declared as a constant operand, the corresponding builder method will take a BytecodeLocal array argument representing the locals to be updated.

Since:

24.2

Method Summary

Modifier and Type	Method	Description
static LocalRangeAccessor	constantOf(BytecodeLocal[] locals)	Creates a local setter range given an array of bytecode locals created by the builder.
boolean	equals(Object obj)
boolean	getBoolean(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads a boolean from a local at the given offset into the range.
byte	getByte(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads a byte from a local at the given offset into the range.
double	getDouble(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads a double from a local at the given offset into the range.
float	getFloat(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads a float from a local at the given offset into the range.
int	getInt(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads an int from a local at the given offset into the range.
int	getLength()	Returns the length of the range.
long	getLong(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads a long from a local at the given offset into the range.
Object	getObject(BytecodeNode bytecode, VirtualFrame frame, int offset)	Loads an object from a local at the given offset into the range.
int	hashCode()
void	setBoolean(BytecodeNode bytecode, VirtualFrame frame, int offset, boolean value)	Stores a boolean into the local at the given offset into the range.
void	setByte(BytecodeNode bytecode, VirtualFrame frame, int offset, byte value)	Stores a byte into the local at the given offset into the range.
void	setDouble(BytecodeNode bytecode, VirtualFrame frame, int offset, double value)	Stores a double into the local at the given offset into the range.
void	setFloat(BytecodeNode bytecode, VirtualFrame frame, int offset, float value)	Stores a float into the local at the given offset into the range.
void	setInt(BytecodeNode bytecode, VirtualFrame frame, int offset, int value)	Stores an int into the local at the given offset into the range.
void	setLong(BytecodeNode bytecode, VirtualFrame frame, int offset, long value)	Stores a long into the local at the given offset into the range.
void	setObject(BytecodeNode bytecode, VirtualFrame frame, int offset, Object value)	Stores an object into the local at the given offset into the range.
String	toString()	Returns a string representation of a LocalRangeAccessor.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Details

getLength

public int getLength()

Returns the length of the range.

Since:

24.2

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Returns a string representation of a LocalRangeAccessor.

Overrides:

toString in class Object

Since:

24.2

getObject

public Object getObject(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)

Loads an object from a local at the given offset into the range.

Since:

24.2

getBoolean

public boolean getBoolean(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
                   throws UnexpectedResultException

Loads a boolean from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

getByte

public byte getByte(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
             throws UnexpectedResultException

Loads a byte from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

getInt

public int getInt(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
           throws UnexpectedResultException

Loads an int from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

getLong

public long getLong(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
             throws UnexpectedResultException

Loads a long from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

getFloat

public float getFloat(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
               throws UnexpectedResultException

Loads a float from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

getDouble

public double getDouble(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset)
                 throws UnexpectedResultException

Loads a double from a local at the given offset into the range.

Throws:

UnexpectedResultException

Since:

24.2

setObject

public void setObject(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 Object value)

Stores an object into the local at the given offset into the range.

Since:

24.2

setInt

public void setInt(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 int value)

Stores an int into the local at the given offset into the range.

Since:

24.2

setLong

public void setLong(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 long value)

Stores a long into the local at the given offset into the range.

Since:

24.2

setBoolean

public void setBoolean(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 boolean value)

Stores a boolean into the local at the given offset into the range.

Since:

24.2

setByte

public void setByte(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 byte value)

Stores a byte into the local at the given offset into the range.

Since:

24.2

setFloat

public void setFloat(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 float value)

Stores a float into the local at the given offset into the range.

Since:

24.2

setDouble

public void setDouble(BytecodeNode bytecode,
 VirtualFrame frame,
 int offset,
 double value)

Stores a double into the local at the given offset into the range.

Since:

24.2

constantOf

public static LocalRangeAccessor constantOf(BytecodeLocal[] locals)

Creates a local setter range given an array of bytecode locals created by the builder. The array of bytecode locals must locals with consective localOffset. The returned value may return an interned instance of LocalRangeAccessor to improve memory footprint.

Since:

24.2