org.graalvm.compiler.nodes

Class NamedLocationIdentity

java.lang.Object

org.graalvm.word.LocationIdentity

org.graalvm.compiler.nodes.NamedLocationIdentity

public class NamedLocationIdentity
extends org.graalvm.word.LocationIdentity

A LocationIdentity with a name.

Field Summary

Fields

Modifier and Type	Field and Description
static org.graalvm.word.LocationIdentity	ARRAY_LENGTH_LOCATION Denotes the location of the length field of a Java array.
static org.graalvm.word.LocationIdentity	FINAL_LOCATION Denotes the location of a value that is guaranteed to be unchanging.
static org.graalvm.word.LocationIdentity	OFF_HEAP_LOCATION Denotes an off-heap address.

Fields inherited from class org.graalvm.word.LocationIdentity

ANY_LOCATION, INIT_LOCATION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NamedLocationIdentity(String name, boolean immutable)

Method Summary

Modifier and Type	Method and Description
static org.graalvm.word.LocationIdentity	getArrayLocation(JavaKind elementKind) Returns the named location identity for an array of the given element kind.
static NamedLocationIdentity	immutable(String name) Creates a named unique location identity for read operations against immutable memory.
static boolean	isArrayLocation(org.graalvm.word.LocationIdentity l)
boolean	isImmutable()
static NamedLocationIdentity	mutable(String name) Creates a named unique location identity for read and write operations against mutable memory.
String	toString()

Methods inherited from class org.graalvm.word.LocationIdentity

any, init, isAny, isInit, isMutable, isSingle, overlaps

Methods inherited from class java.lang.Object

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

Field Detail

FINAL_LOCATION

public static final org.graalvm.word.LocationIdentity FINAL_LOCATION

Denotes the location of a value that is guaranteed to be unchanging.

ARRAY_LENGTH_LOCATION

public static final org.graalvm.word.LocationIdentity ARRAY_LENGTH_LOCATION

Denotes the location of the length field of a Java array.

OFF_HEAP_LOCATION

public static final org.graalvm.word.LocationIdentity OFF_HEAP_LOCATION

Denotes an off-heap address.

Constructor Detail

NamedLocationIdentity

protected NamedLocationIdentity(String name,
                                boolean immutable)

Method Detail

mutable

public static NamedLocationIdentity mutable(String name)

Creates a named unique location identity for read and write operations against mutable memory.

Parameters:

name - the name of the new location identity

immutable

public static NamedLocationIdentity immutable(String name)

Creates a named unique location identity for read operations against immutable memory. Immutable memory will never have a visible write in the graph, which is more restrictive than Java final.

Parameters:

name - the name of the new location identity

isImmutable

public boolean isImmutable()

Specified by:

isImmutable in class org.graalvm.word.LocationIdentity

toString

public String toString()

Overrides:

toString in class Object

getArrayLocation

public static org.graalvm.word.LocationIdentity getArrayLocation(JavaKind elementKind)

Returns the named location identity for an array of the given element kind. Array accesses of the same kind must have the same location identity unless an alias analysis guarantees that two distinct arrays are accessed.

isArrayLocation

public static boolean isArrayLocation(org.graalvm.word.LocationIdentity l)