Class MaterializedLocalAccessor

java.lang.Object

com.oracle.truffle.api.bytecode.MaterializedLocalAccessor

public final class MaterializedLocalAccessor
extends Object

Operation parameter that allows an operation to get, set, and clear the value of a local from a materialized frame of the current root node or an outer root node. This class can only be used if the root node supports materialized local accesses.

To use a materialized local accessor, declare a ConstantOperand on the operation. The corresponding builder method for the operation will take a BytecodeLocal argument for the local to be accessed. At run time, a MaterializedLocalAccessor for the local will be supplied as a parameter to the operation.

Materialized local accessors are useful to implement behaviour that cannot be implemented with the builtin materialized local operations (like StoreLocalMaterialized), nor with plain local accessors.

All of the materialized accessor methods take a bytecode node and the current frame. The bytecode node should be the current bytecode node (not necessarily corresponding to the root node that declares the local); it should be compilation-final. The frame should contain the local and be materialized.

Example usage:

@Operation
@ConstantOperand(type = MaterializedLocalAccessor.class)
public static final class GetMaterializedLocal {
    @Specialization
    public static Object perform(VirtualFrame frame,
                    MaterializedLocalAccessor accessor,
                    MaterializedFrame materializedFrame,
                    @Bind BytecodeNode bytecodeNode) {
        return accessor.getObject(bytecodeNode, materializedFrame);
    }
}

Since:

24.2

Method Summary

Modifier and Type	Method	Description
void	clear(BytecodeNode bytecodeNode, MaterializedFrame frame)	Clears the local from the frame.
static MaterializedLocalAccessor	constantOf(int rootIndex, BytecodeLocal local)	Obtains a MaterializedLocalAccessor.
boolean	equals(Object obj)
boolean	getBoolean(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads a boolean from the local.
byte	getByte(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads a byte from the local.
double	getDouble(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads a double from the local.
float	getFloat(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads a float from the local.
int	getInt(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads an int from the local.
Object	getLocalInfo(BytecodeNode bytecodeNode)	Returns the info associated with the local.
Object	getLocalName(BytecodeNode bytecodeNode)	Returns the name associated with the local.
long	getLong(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads a long from the local.
Object	getObject(BytecodeNode bytecodeNode, MaterializedFrame frame)	Loads an object from the local.
int	hashCode()
boolean	isCleared(BytecodeNode bytecodeNode, MaterializedFrame frame)	Checks whether the local has been cleared (and a new value has not been set).
void	setBoolean(BytecodeNode bytecodeNode, MaterializedFrame frame, boolean value)	Stores a boolean into the local.
void	setByte(BytecodeNode bytecodeNode, MaterializedFrame frame, byte value)	Stores a byte into the local.
void	setDouble(BytecodeNode bytecodeNode, MaterializedFrame frame, double value)	Stores a double into the local.
void	setFloat(BytecodeNode bytecodeNode, MaterializedFrame frame, float value)	Stores a float into the local.
void	setInt(BytecodeNode bytecodeNode, MaterializedFrame frame, int value)	Stores an int into the local.
void	setLong(BytecodeNode bytecodeNode, MaterializedFrame frame, long value)	Stores a long into the local.
void	setObject(BytecodeNode bytecodeNode, MaterializedFrame frame, Object value)	Stores an object into the local.
String	toString()	Returns a string representation of a MaterializedLocalAccessor.

Methods inherited from class Object

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

Method Details

toString

public String toString()

Returns a string representation of a MaterializedLocalAccessor.

Overrides:

toString in class Object

Since:

24.2

getObject

public Object getObject(BytecodeNode bytecodeNode,
 MaterializedFrame frame)

Loads an object from the local.

Since:

24.2

getBoolean

public boolean getBoolean(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
                   throws UnexpectedResultException

Loads a boolean from the local.

Throws:

UnexpectedResultException

Since:

24.2

getByte

public byte getByte(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
             throws UnexpectedResultException

Loads a byte from the local.

Throws:

UnexpectedResultException

Since:

24.2

getInt

public int getInt(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
           throws UnexpectedResultException

Loads an int from the local.

Throws:

UnexpectedResultException

Since:

24.2

getLong

public long getLong(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
             throws UnexpectedResultException

Loads a long from the local.

Throws:

UnexpectedResultException

Since:

24.2

getFloat

public float getFloat(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
               throws UnexpectedResultException

Loads a float from the local.

Throws:

UnexpectedResultException

Since:

24.2

getDouble

public double getDouble(BytecodeNode bytecodeNode,
 MaterializedFrame frame)
                 throws UnexpectedResultException

Loads a double from the local.

Throws:

UnexpectedResultException

Since:

24.2

setObject

public void setObject(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 Object value)

Stores an object into the local.

Since:

24.2

setBoolean

public void setBoolean(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 boolean value)

Stores a boolean into the local.

Since:

24.2

setByte

public void setByte(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 byte value)

Stores a byte into the local.

Since:

24.2

setInt

public void setInt(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 int value)

Stores an int into the local.

Since:

24.2

setLong

public void setLong(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 long value)

Stores a long into the local.

Since:

24.2

setFloat

public void setFloat(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 float value)

Stores a float into the local.

Since:

24.2

setDouble

public void setDouble(BytecodeNode bytecodeNode,
 MaterializedFrame frame,
 double value)

Stores a double into the local.

Since:

24.2

clear

public void clear(BytecodeNode bytecodeNode,
 MaterializedFrame frame)

Clears the local from the frame.

Clearing the slot marks the frame slot as illegal. An exception will be thrown if it is read before being set. Clearing does not insert a default local value, if specified.

Since:

24.2

isCleared

public boolean isCleared(BytecodeNode bytecodeNode,
 MaterializedFrame frame)

Checks whether the local has been cleared (and a new value has not been set).

This method also returns true if a local has not been initialized and no default local value is specified.

Since:

24.2

getLocalName

public Object getLocalName(BytecodeNode bytecodeNode)

Returns the name associated with the local.

Since:

24.2

See Also:

• BytecodeNode.getLocalName(int, int)

getLocalInfo

public Object getLocalInfo(BytecodeNode bytecodeNode)

Returns the info associated with the local.

Since:

24.2

See Also:

• BytecodeNode.getLocalInfo(int, int)

constantOf

public static MaterializedLocalAccessor constantOf(int rootIndex,
 BytecodeLocal local)

Obtains a MaterializedLocalAccessor. This method is invoked by the generated code and should not be called directly.

Since:

24.2

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object