com.oracle.graal.nodes.java

Class ArrayLengthNode

java.lang.Object

com.oracle.graal.graph.Node

com.oracle.graal.nodes.ValueNode

com.oracle.graal.nodes.FixedNode

com.oracle.graal.nodes.FixedWithNextNode

com.oracle.graal.nodes.java.ArrayLengthNode

All Implemented Interfaces:

NodeInterface, Canonicalizable, Canonicalizable.Unary<ValueNode>, Lowerable, Virtualizable, Cloneable, Formattable, KindProvider

public final class ArrayLengthNode
extends FixedWithNextNode
implements Canonicalizable.Unary<ValueNode>, Lowerable, Virtualizable

The ArrayLength instruction gets the length of an array.

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.graal.graph.Node

Node.ConstantNodeParameter, Node.InjectedNodeParameter, Node.Input, Node.NodeIntrinsic, Node.OptionalInput, Node.Successor, Node.ValueNumberable

Nested classes/interfaces inherited from interface com.oracle.graal.graph.spi.Canonicalizable

Canonicalizable.Binary<T extends Node>, Canonicalizable.BinaryCommutative<T extends Node>, Canonicalizable.Unary<T extends Node>

Field Summary

Fields

Modifier and Type	Field and Description
(package private) ValueNode	array
static NodeClass<ArrayLengthNode>	TYPE

Fields inherited from class com.oracle.graal.nodes.FixedWithNextNode

next

Fields inherited from class com.oracle.graal.nodes.ValueNode

stamp

Fields inherited from class com.oracle.graal.graph.Node

NODE_LIST, NOT_ITERABLE, USE_UNSAFE_TO_CLONE, WithAllEdges, WithNoEdges, WithOnlyInputEdges, WithOnlySucessorEdges

Constructor Summary

Constructors

Constructor and Description
ArrayLengthNode(ValueNode array)

Method Summary

Modifier and Type	Method and Description
ValueNode	array()
static int	arrayLength(Object array)
ValueNode	canonical(CanonicalizerTool tool, ValueNode forValue) Similar to Canonicalizable.canonical(CanonicalizerTool), except that implementations should act as if the current input of the node was the given one, i.e., they should never look at the inputs via the this pointer.
static ValueNode	create(ValueNode forValue, ConstantReflectionProvider constantReflection)
ValueNode	getValue() Gets the current value of the input, so that calling Canonicalizable.Unary.canonical(CanonicalizerTool, Node) with the value returned from this method should behave exactly like Canonicalizable.canonical(CanonicalizerTool).
void	lower(LoweringTool tool) Expand this node into lower level nodes expressing the same semantics.
static ValueNode	readArrayLength(ValueNode originalArray, ConstantReflectionProvider constantReflection) Gets the length of an array if possible.
private static ValueNode	readArrayLengthConstant(ValueNode originalArray, ConstantReflectionProvider constantReflection)
private static ValueNode	reproxyValue(ValueNode originalValue, ValueNode value) Replicate the ValueProxyNodes from originalValue onto value.
void	virtualize(VirtualizerTool tool) A node class can implement this method to convey information about what its effect would be if some of its inputs were virtualized.

Methods inherited from class com.oracle.graal.nodes.FixedWithNextNode

asNode, next, setNext

Methods inherited from class com.oracle.graal.nodes.FixedNode

verify

Methods inherited from class com.oracle.graal.nodes.ValueNode

asConstant, asJavaConstant, getKind, graph, inferStamp, isAllowedUsageType, isConstant, isConstantPredicate, isNullConstant, setStamp, stamp, updateStamp

Methods inherited from class com.oracle.graal.graph.Node

acceptInputs, acceptSuccessors, afterClone, assertFalse, assertTrue, cfgPredecessors, cfgSuccessors, clearInputs, clearSuccessors, copyWithInputs, copyWithInputs, equals, fail, formatTo, getDebugProperties, getDebugProperties, getId, getNodeClass, getUsageAt, getUsageCount, hashCode, hasNoUsages, hasUsages, inputs, isAlive, isDeleted, markDeleted, modCount, newIdentityMap, newIdentityMap, newIdentityMap, newMap, newMap, newMap, newSet, newSet, predecessor, pushInputs, removeUsage, replaceAndDelete, replaceAtMatchingUsages, replaceAtPredecessor, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceFirstInput, replaceFirstSuccessor, safeDelete, simplify, successors, toString, toString, updatePredecessor, updateUsages, updateUsagesInterface, usages, valueEquals, verifyEdges, verifyInputs

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.graal.graph.spi.Canonicalizable.Unary

canonical

Methods inherited from interface com.oracle.graal.nodes.spi.Lowerable

asNode

Field Detail

TYPE

public static final NodeClass<ArrayLengthNode> TYPE

array

ValueNode array

Constructor Detail

ArrayLengthNode

public ArrayLengthNode(ValueNode array)

Method Detail

array

public ValueNode array()

getValue

public ValueNode getValue()

Description copied from interface: Canonicalizable.Unary

Gets the current value of the input, so that calling Canonicalizable.Unary.canonical(CanonicalizerTool, Node) with the value returned from this method should behave exactly like Canonicalizable.canonical(CanonicalizerTool).

Specified by:

getValue in interface Canonicalizable.Unary<ValueNode>

create

public static ValueNode create(ValueNode forValue,
                               ConstantReflectionProvider constantReflection)

canonical

public ValueNode canonical(CanonicalizerTool tool,
                           ValueNode forValue)

Description copied from interface: Canonicalizable.Unary

Similar to Canonicalizable.canonical(CanonicalizerTool), except that implementations should act as if the current input of the node was the given one, i.e., they should never look at the inputs via the this pointer.

Specified by:

canonical in interface Canonicalizable.Unary<ValueNode>

reproxyValue

private static ValueNode reproxyValue(ValueNode originalValue,
                                      ValueNode value)

Replicate the ValueProxyNodes from originalValue onto value.

Parameters:

originalValue - a possibly proxied value

value - a value needing proxies

Returns:

proxies wrapping value

readArrayLength

public static ValueNode readArrayLength(ValueNode originalArray,
                                        ConstantReflectionProvider constantReflection)

Gets the length of an array if possible.

Returns:

a node representing the length of array or null if it is not available

readArrayLengthConstant

private static ValueNode readArrayLengthConstant(ValueNode originalArray,
                                                 ConstantReflectionProvider constantReflection)

lower

public void lower(LoweringTool tool)

Description copied from interface: Lowerable

Expand this node into lower level nodes expressing the same semantics. If the introduced nodes are themselves lowerable, they should be recursively lowered as part of this call.

Specified by:

lower in interface Lowerable

arrayLength

public static int arrayLength(Object array)

virtualize

public void virtualize(VirtualizerTool tool)

Description copied from interface: Virtualizable

A node class can implement this method to convey information about what its effect would be if some of its inputs were virtualized. All modifications must be made through the supplied tool, and not directly on the node, because by the time this method is called the virtualized/non-virtualized state is still speculative and might not hold because of loops, etc.

Specified by:

virtualize in interface Virtualizable

Parameters:

tool - the tool used to describe the effects of this node