com.oracle.truffle.object

Class Locations.ValueLocation

java.lang.Object

com.oracle.truffle.api.object.Location

com.oracle.truffle.object.LocationImpl

com.oracle.truffle.object.Locations.ValueLocation

Direct Known Subclasses:

Locations.ConstantLocation, Locations.DeclaredLocation

Enclosing class:

Locations

public abstract static class Locations.ValueLocation
extends LocationImpl

Since:

0.17 or earlier

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.truffle.object.LocationImpl

LocationImpl.InternalLongLocation, LocationImpl.LocationVisitor

Constructor Summary

Constructors

Constructor and Description
ValueLocation(Object value)

Method Summary

Modifier and Type	Method and Description
void	accept(LocationImpl.LocationVisitor locationVisitor) Accept a visitor for location allocation for this and every nested location.
boolean	canStore(Object val) Returns true if the location is compatible with the type of the value.
boolean	equals(Object obj) Abstract to force overriding.
Object	get(DynamicObject store, boolean condition) Get object value as object at this location in store.
int	hashCode() Abstract to force overriding.
boolean	isValue() Returns true if this is a value location.
void	set(DynamicObject store, Object value, Shape shape) Set object value at this location in store.
void	setInternal(DynamicObject store, Object value) Like Location.set(DynamicObject, Object, Shape), but does not invalidate final locations.
String	toString()

Methods inherited from class com.oracle.truffle.object.LocationImpl

canSet, canSet, canStoreFinal, getInternal, getWhereString, isConstant, isFinal, objectArrayCount, objectFieldCount, primitiveArrayCount, primitiveFieldCount, valueEquals

Methods inherited from class com.oracle.truffle.api.object.Location

checkShape, finalLocation, get, get, getFinalAssumption, incompatibleLocation, isAssumedFinal, isDeclared, set, set

Methods inherited from class java.lang.Object

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

Constructor Detail

ValueLocation

public ValueLocation(Object value)

Since:

0.17 or earlier

Method Detail

hashCode

public int hashCode()

Description copied from class: Location

Abstract to force overriding.

Overrides:

hashCode in class LocationImpl

Since:

0.17 or earlier

equals

public boolean equals(Object obj)

Description copied from class: Location

Abstract to force overriding.

Overrides:

equals in class LocationImpl

Since:

0.17 or earlier

get

public final Object get(DynamicObject store,
                        boolean condition)

Description copied from class: Location

Get object value as object at this location in store. For internal use only and subject to change, use Location.get(DynamicObject, Shape) instead.

Overrides:

get in class Location

condition - the result of a shape check or false

Since:

0.17 or earlier

See Also:

Location.get(DynamicObject, Shape)

set

public final void set(DynamicObject store,
                      Object value,
                      Shape shape)
               throws IncompatibleLocationException,
                      FinalLocationException

Description copied from class: Location

Set object value at this location in store.

Overrides:

set in class LocationImpl

shape - the current shape of the storage object

Throws:

IncompatibleLocationException - for storage type invalidations

FinalLocationException - for effectively final fields

Since:

0.17 or earlier

canStore

public boolean canStore(Object val)

Description copied from class: Location

Returns true if the location is compatible with the type of the value. The actual value may still be rejected if Location.canSet(DynamicObject, Object) returns false.

Overrides:

canStore in class LocationImpl

Parameters:

val - the value in question

Since:

0.17 or earlier

setInternal

public final void setInternal(DynamicObject store,
                              Object value)
                       throws IncompatibleLocationException

Description copied from class: Location

Like Location.set(DynamicObject, Object, Shape), but does not invalidate final locations. For internal use only and subject to change, use DynamicObjectFactory to create objects with predefined properties.

Specified by:

setInternal in class LocationImpl

Throws:

IncompatibleLocationException - if value is of non-assignable type

Since:

0.17 or earlier

toString

public String toString()

Overrides:

toString in class LocationImpl

Since:

0.17 or earlier

accept

public final void accept(LocationImpl.LocationVisitor locationVisitor)

Description copied from class: LocationImpl

Accept a visitor for location allocation for this and every nested location.

Specified by:

accept in class LocationImpl

Parameters:

locationVisitor - visitor to be notified of every allocated slot in use by this location

Since:

0.17 or earlier

isValue

public final boolean isValue()

Description copied from class: Location

Returns true if this is a value location.

Overrides:

isValue in class Location

Since:

0.18

See Also:

Location.isConstant(), Location.isDeclared()