com.oracle.truffle.api.object

Class Shape.Allocator

java.lang.Object

com.oracle.truffle.api.object.Shape.Allocator

Enclosing class:

Shape

public abstract static class Shape.Allocator
extends Object

Utility class to allocate locations in an object layout.

Since:

0.8 or earlier

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Allocator()

Method Summary

Modifier and Type	Method and Description
abstract Shape.Allocator	addLocation(Location location) Reserves space for the given location, so that it will not be available to subsequently allocated locations.
abstract Location	constantLocation(Object value) Creates a new location from a constant value.
abstract Shape.Allocator	copy() Creates an copy of this allocator state.
abstract Location	declaredLocation(Object value) Creates a new declared location with a default value.
Location	locationForType(Class<?> type) Create a new location for a fixed type.
protected abstract Location	locationForType(Class<?> type, boolean useFinal, boolean nonNull)
Location	locationForType(Class<?> type, EnumSet<LocationModifier> modifiers) Create a new location for a fixed type.
Location	locationForValue(Object value) Create a new location compatible with the given initial value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Allocator

protected Allocator()

Since:

0.8 or earlier

Method Detail

locationForValue

public final Location locationForValue(Object value)

Create a new location compatible with the given initial value. Use Shape.Allocator.locationForType(Class) or Shape.defineProperty(Object, Object, int) instead.

Parameters:

value - the initial value this location is going to be assigned

Since:

0.8 or earlier

locationForType

protected abstract Location locationForType(Class<?> type,
                                            boolean useFinal,
                                            boolean nonNull)

Since:

0.8 or earlier

locationForType

public final Location locationForType(Class<?> type)

Create a new location for a fixed type. It can only be assigned to values of this type.

Parameters:

type - the Java type this location must be compatible with (may be primitive)

Since:

0.8 or earlier

locationForType

public final Location locationForType(Class<?> type,
                                      EnumSet<LocationModifier> modifiers)

Create a new location for a fixed type.

Parameters:

type - the Java type this location must be compatible with (may be primitive)

modifiers - additional restrictions and semantics

Since:

0.8 or earlier

constantLocation

public abstract Location constantLocation(Object value)

Creates a new location from a constant value. The value is stored in the shape rather than in the object.

Since:

0.8 or earlier

declaredLocation

public abstract Location declaredLocation(Object value)

Creates a new declared location with a default value. A declared location only assumes a type after the first set (initialization).

Since:

0.8 or earlier

addLocation

public abstract Shape.Allocator addLocation(Location location)

Reserves space for the given location, so that it will not be available to subsequently allocated locations.

Since:

0.8 or earlier

copy

public abstract Shape.Allocator copy()

Creates an copy of this allocator state.

Since:

0.8 or earlier