AvailInstruction

abstract class AvailInstruction(var relevantTokens: A_Tuple)

AvailInstruction implements an abstract instruction set that doesn't have to agree precisely with the actual implemented Level One nybblecode instruction set. The mapping is approximately one-to-one, however, other than providing the ability to defer certain analyses, such as last-use of variables, until after selection of AvailInstructions. This allows the analysis to simply mark the already abstractly-emitted instructions with information that affects the precise nybblecodes that will ultimately be emitted.

Author

Mark van Gulik

Parameters

relevantTokens

The A_Tuple of A_Tokens that are associated with this instruction.

Inheritors

Constructors

Link copied to clipboard
constructor(relevantTokens: A_Tuple)

Construct an instruction. Capture the tokens that contributed to it.

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard

true iff this instruction is a use of an outer variable.

Link copied to clipboard

Answer which line number to say that this instruction occurs on. Use the relevantTokens as an approximation, but subclasses might be able to be more precise. Answer -1 if this instruction doesn't seem to have a location in the source associated with it.

Link copied to clipboard

The tuple of tokens that contributed to producing this instruction.

Functions

Link copied to clipboard

The instructions of a block are being iterated over. Coordinate optimizations between instructions using localData and outerData, two lists manipulated by overrides of this method. Treat each instruction as though it is the last one in the block, and save enough information in the lists to be able to undo consequences of this assumption when a later instruction shows it to be unwarranted.

Link copied to clipboard
open fun writeLineNumberDeltasOn(encodedLineNumberDeltas: MutableList<Int>, currentLineNumber: Int): Int

Write an entry to the encoded line number deltas for each L1 instruction generated. Most AvailInstructions write a single L1 instruction, so that implementation is here.

Link copied to clipboard
abstract fun writeNybblesOn(aStream: NybbleOutputStream)

Write nybbles representing this instruction to the NybbleOutputStream.