org.graalvm.compiler.phases

Class BasePhase.NotApplicable

java.lang.Object

org.graalvm.compiler.phases.BasePhase.NotApplicable

Enclosing class:

BasePhase<C>

public static class BasePhase.NotApplicable
extends Object

Explains why a phase cannot be applied to a given graph.

Field Summary

Fields

Modifier and Type	Field and Description
Throwable	cause Contains the Throwable that could be thrown if the phase was executed.
String	reason Describes why a phase cannot be applied at this point of the compilation.

Constructor Summary

Constructors

Constructor and Description
NotApplicable(String reason)
NotApplicable(String reason, Throwable cause)
NotApplicable(Throwable cause)

Method Summary

Modifier and Type	Method and Description
static Optional<BasePhase.NotApplicable>	canOnlyApplyOnce(BasePhase<?> phase, GraphState.StageFlag flag, GraphState graphState) Constructs an Optional from a BasePhase.NotApplicable stating the given stage was already applied and cannot be applied a second time if the stage is already applied to the GraphState.
static Optional<BasePhase.NotApplicable>	combineConstraints(Optional<BasePhase.NotApplicable>... constraints) Combines the given constraints.
static Optional<BasePhase.NotApplicable>	mustRunAfter(BasePhase<?> phase, GraphState.StageFlag flag, GraphState graphState) Constructs an Optional from a BasePhase.NotApplicable stating the given phase must run after the given GraphState.StageFlag if the GraphState is before that stage.
static Optional<BasePhase.NotApplicable>	mustRunBefore(BasePhase<?> phase, GraphState.StageFlag flag, GraphState graphState) Constructs an Optional from a BasePhase.NotApplicable stating the given phase must run before the given GraphState.StageFlag if the GraphState is already after that stage.
static Optional<BasePhase.NotApplicable>	mustWeakenFrameStateVerification(BasePhase<?> phase, GraphState.FrameStateVerification flag, GraphState graphState) Constructs an Optional from a BasePhase.NotApplicable stating the GraphState.FrameStateVerification cannot be weakened if the frame state verification has already been weakened past the desired stage.
static Optional<BasePhase.NotApplicable>	notApplicableIf(boolean condition, Optional<BasePhase.NotApplicable> notApplicable)
String	toString()
static Optional<BasePhase.NotApplicable>	undefinedSpeculationLog(BasePhase<?> phase, GraphState graphState) Constructs an Optional from a BasePhase.NotApplicable stating the given phase needs a defined SpeculationLog if the given GraphState does not have one.

Methods inherited from class java.lang.Object

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

Field Detail

reason

public final String reason

Describes why a phase cannot be applied at this point of the compilation.

cause

public final Throwable cause

Contains the Throwable that could be thrown if the phase was executed. May be null.

Constructor Detail

NotApplicable

public NotApplicable(String reason,
                     Throwable cause)

NotApplicable

public NotApplicable(String reason)

NotApplicable

public NotApplicable(Throwable cause)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

notApplicableIf

public static Optional<BasePhase.NotApplicable> notApplicableIf(boolean condition,
                                                                Optional<BasePhase.NotApplicable> notApplicable)

Returns:

the given Optional.of(T) BasePhase.NotApplicable if the condition is true. Otherwise, returns BasePhase.ALWAYS_APPLICABLE.

mustRunBefore

public static Optional<BasePhase.NotApplicable> mustRunBefore(BasePhase<?> phase,
                                                              GraphState.StageFlag flag,
                                                              GraphState graphState)

Constructs an Optional from a BasePhase.NotApplicable stating the given phase must run before the given GraphState.StageFlag if the GraphState is already after that stage. Otherwise, returns BasePhase.ALWAYS_APPLICABLE. This can be used to create a return value for BasePhase.canApply(org.graalvm.compiler.nodes.GraphState).

mustRunAfter

public static Optional<BasePhase.NotApplicable> mustRunAfter(BasePhase<?> phase,
                                                             GraphState.StageFlag flag,
                                                             GraphState graphState)

Constructs an Optional from a BasePhase.NotApplicable stating the given phase must run after the given GraphState.StageFlag if the GraphState is before that stage. Otherwise, returns BasePhase.ALWAYS_APPLICABLE. This can be used to create a return value for BasePhase.canApply(org.graalvm.compiler.nodes.GraphState).

canOnlyApplyOnce

public static Optional<BasePhase.NotApplicable> canOnlyApplyOnce(BasePhase<?> phase,
                                                                 GraphState.StageFlag flag,
                                                                 GraphState graphState)

Constructs an Optional from a BasePhase.NotApplicable stating the given stage was already applied and cannot be applied a second time if the stage is already applied to the GraphState. Otherwise, returns BasePhase.ALWAYS_APPLICABLE. This can be used to create a return value for BasePhase.canApply(org.graalvm.compiler.nodes.GraphState).

mustWeakenFrameStateVerification

public static Optional<BasePhase.NotApplicable> mustWeakenFrameStateVerification(BasePhase<?> phase,
                                                                                 GraphState.FrameStateVerification flag,
                                                                                 GraphState graphState)

Constructs an Optional from a BasePhase.NotApplicable stating the GraphState.FrameStateVerification cannot be weakened if the frame state verification has already been weakened past the desired stage. Otherwise, returns BasePhase.ALWAYS_APPLICABLE. This can be used to create a return value for BasePhase.canApply(org.graalvm.compiler.nodes.GraphState).

undefinedSpeculationLog

public static Optional<BasePhase.NotApplicable> undefinedSpeculationLog(BasePhase<?> phase,
                                                                        GraphState graphState)

Constructs an Optional from a BasePhase.NotApplicable stating the given phase needs a defined SpeculationLog if the given GraphState does not have one. Otherwise, returns BasePhase.ALWAYS_APPLICABLE. This can be used to create a return value for BasePhase.canApply(org.graalvm.compiler.nodes.GraphState).

combineConstraints

@SafeVarargs
public static Optional<BasePhase.NotApplicable> combineConstraints(Optional<BasePhase.NotApplicable>... constraints)

Combines the given constraints.

Returns:

Optional.empty() if all the constraints are empty, Optional#of(NotApplicable) containing all the constraints that make this phase not applicable otherwise.