solve-concurrent/it.unibo.tuprolog.solve.concurrent.fsm/StatePrimitiveExecution

StatePrimitiveExecution

data class StatePrimitiveExecution(val context: ConcurrentExecutionContext) : AbstractState

"Primitive Execution": applies the outcome of one Solve.Response produced by a primitive (see StatePrimitiveSelection) to the branch's context -- a successful response's side effects and substitution are merged in and resolution continues with StateGoalSelection on the remaining goals; a failed response (Solution.No) ends this branch as a failure; a halting response, or an uncaught ResolutionException thrown while computing it, moves to StateException.

Constructors

constructor(context: ConcurrentExecutionContext)

Properties

context

open override val context: ConcurrentExecutionContext

The execution context this state operates on.

isEndState

open val isEndState: Boolean

Whether this state is a terminal one for the current branch, i.e. an EndState.

Functions

asEndState

open fun asEndState(): EndState?

This state as an EndState, or null if isEndState is false.

castToEndState

open fun castToEndState(): EndState

This state as an EndState.

clone

open override fun clone(context: ConcurrentExecutionContext = this.context): StatePrimitiveExecution

Returns a copy of this state, replacing context with the given one (defaulting to the current context).

open override fun next(): Iterable<State>

Computes every state this branch may transition into from here, one per alternative (matching clause, disjunct, primitive solution, ...) available at this point; empty only for EndStates. Each element is meant to be explored independently (and, in :solve-concurrent's solver, concurrently) of the others.