avail/avail.interpreter.levelTwoSimple/L2Simple_AbstractInvokerInstruction

L2Simple_AbstractInvokerInstruction

abstract class L2Simple_AbstractInvokerInstruction( val stackp: Int, val pc: Int, val nextOffset: Int, val liveIndices: IntArray, val expectedType: A_Type, val mustCheck: Boolean) : L2Simple_AbstractReifiableInstruction

An abstract class for instructions whose primary purpose is to invoke some other function. The expectedType indicates what type should be pushed on the stack if reification happens. If mustCheck is true, the expectedType is also used to check that the eventually returned value is of the correct type.

Constructors

fun L2Simple_AbstractInvokerInstruction( stackp: Int, pc: Int, nextOffset: Int, liveIndices: IntArray, expectedType: A_Type, mustCheck: Boolean)

Functions

fieldValueToString

fun fieldValueToString(value: Any?): String

Generate a suitable print representation of the value.

handleVariableGetException

fun handleVariableGetException( e: VariableGetException, interpreter: Interpreter, registers: Array<AvailObject>): StackReifier

A VariableGetException has occurred. Invoke the READ_UNASSIGNED_VARIABLE hook function, which, because it is ⊥-valued, can only reify. Eventually answer that StackReifier.

handleVariableSetException

fun handleVariableSetException( e: VariableSetException, variable: A_Variable, value: AvailObject, interpreter: Interpreter, registers: Array<AvailObject>): StackReifier?

A VariableSetException has occurred. Run the implicit-observe handler, and answer null if it completes, or a suitable StackReifier if it eventually reifies.

reenter

open override fun reenter(registers: Array<AvailObject>, interpreter: Interpreter): StackReifier?

This is called when the invocation for this step had to reify, and now we've finished the actual Avail call and we're attempting to continue where we left off. We have to check the returned value and either capture it on the stack or invoke the result check failure function.

step

abstract fun step(registers: Array<AvailObject>, interpreter: Interpreter): StackReifier?

Perform this instruction, a single step of an L2SimpleChunk. The mutable Array of AvailObjects acts as a simple set of registers. Element 0 is the current function, and the remaining elements correspond with the continuation slots, should one need to be constructed.

toString