com.oracle.truffle.api.nodes

Enum ExplodeLoop.LoopExplosionKind

java.lang.Object

java.lang.Enum<ExplodeLoop.LoopExplosionKind>

com.oracle.truffle.api.nodes.ExplodeLoop.LoopExplosionKind

All Implemented Interfaces:

Serializable, Comparable<ExplodeLoop.LoopExplosionKind>

Enclosing class:

ExplodeLoop

public static enum ExplodeLoop.LoopExplosionKind
extends Enum<ExplodeLoop.LoopExplosionKind>

Controls behavior of ExplodeLoop annotation.

Since:

0.15

Enum Constant Summary

Enum Constants

Enum Constant and Description
FULL_EXPLODE Fully explode all loops.
FULL_EXPLODE_UNTIL_RETURN Like ExplodeLoop.LoopExplosionKind.FULL_EXPLODE, but in addition explosion does not stop at loop exits.
FULL_UNROLL Fully unroll all loops.
MERGE_EXPLODE like ExplodeLoop.LoopExplosionKind.FULL_EXPLODE, but copies of the loop body that have the exact same state (all local variables have the same value) are merged.

Method Summary

Modifier and Type	Method and Description
static ExplodeLoop.LoopExplosionKind	valueOf(String name) Returns the enum constant of this type with the specified name.
static ExplodeLoop.LoopExplosionKind[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

FULL_UNROLL

public static final ExplodeLoop.LoopExplosionKind FULL_UNROLL

Fully unroll all loops. The loops must have a known finite number of iterations. If a loop has multiple loop ends, they are merged so that the subsequent loop iteration is processed only once. For example, a loop with 4 iterations and 2 loop ends leads to 1+1+1+1 = 4 copies of the loop body.

Since:

0.15

FULL_EXPLODE

public static final ExplodeLoop.LoopExplosionKind FULL_EXPLODE

Fully explode all loops. The loops must have a known finite number of iterations. If a loop has multiple loop ends, they are not merged so that subsequent loop iterations are processed multiple times. For example, a loop with 4 iterations and 2 loop ends leads to 1+2+4+8 = 15 copies of the loop body.

Since:

0.15

FULL_EXPLODE_UNTIL_RETURN

public static final ExplodeLoop.LoopExplosionKind FULL_EXPLODE_UNTIL_RETURN

Like ExplodeLoop.LoopExplosionKind.FULL_EXPLODE, but in addition explosion does not stop at loop exits. Code after the loop is duplicated for every loop exit of every loop iteration. For example, a loop with 4 iterations and 2 loop exits leads to 4 * 2 = 8 copies of the code after the loop.

Since:

0.15

MERGE_EXPLODE

public static final ExplodeLoop.LoopExplosionKind MERGE_EXPLODE

like ExplodeLoop.LoopExplosionKind.FULL_EXPLODE, but copies of the loop body that have the exact same state (all local variables have the same value) are merged. This reduces the number of copies necessary, but can introduce loops again. This kind is useful for bytecode interpreter loops.

Since:

0.15

Method Detail

values

public static ExplodeLoop.LoopExplosionKind[] values()

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ExplodeLoop.LoopExplosionKind valueOf(String name)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null