L2WriteBoxedOperand

class L2WriteBoxedOperand(    semanticValues: Set<L2SemanticValue>,     restriction: TypeRestriction,     register: L2BoxedRegister) : L2WriteOperand<L2BoxedRegister>

An L2WriteBoxedOperand is an operand of type L2OperandType.WRITE_BOXED. It holds the actual L2BoxedRegister that is to be accessed.

Author

Mark van Gulik

Parameters

semanticValues

The Set of L2SemanticValue that this operand is effectively producing.

restriction

The TypeRestriction that indicates what values are allowed to be written into the register.

register

The initial L2BoxedRegister that backs this operand.

Constructors

Link copied to clipboard
fun L2WriteBoxedOperand(    semanticValues: Set<L2SemanticValue>,     restriction: TypeRestriction,     register: L2BoxedRegister)

Construct a new L2WriteBoxedOperand for the specified L2SemanticValue.

Functions

Link copied to clipboard
open override fun addDestinationRegistersTo(destinationRegisters: MutableList<L2Register>)

Move any registers used as destinations within me into the provided list.

Link copied to clipboard
open fun addReadsTo(readOperands: MutableList<L2ReadOperand<*>>)

Capture all L2ReadOperands within this operand into the provided List.

Link copied to clipboard
open fun addSourceRegistersTo(sourceRegisters: MutableList<L2Register>)

Move any registers used as sources within me into the provided list.

Link copied to clipboard
open override fun addWritesTo(writeOperands: MutableList<L2WriteOperand<*>>)

Capture all L2WriteOperands within this operand into the provided List.

Link copied to clipboard
open fun adjustCloneForInstruction(theInstruction: L2Instruction)

This is a freshly cloned operand. Adjust it for use in the given L2Instruction. Note that the new instruction has not yet been installed into an L2BasicBlock.

Link copied to clipboard
open override fun appendTo(builder: StringBuilder)

Write a description of this operand to the given StringBuilder.

Link copied to clipboard
fun appendWithWarningsTo(    builder: StringBuilder,     indent: Int,     warningStyleChange: (Boolean) -> Unit)

Append a textual representation of this operand to the provided StringBuilder. If a style change is appropriate while building the string, invoke the warningStyleChange lambda with true to enable the warning style, and false to turn it off again.

Link copied to clipboard
open fun assertHasBeenEmitted()

Assert that this operand knows its instruction, which should always be the case if the instruction has already been emitted.

Link copied to clipboard
open override fun clone(): L2Operand
Link copied to clipboard
open override fun dispatchOperand(dispatcher: L2OperandDispatcher)

Dispatch this L2Operand to the provided L2OperandDispatcher.

Link copied to clipboard
fun finalIndex(): Int

Answer the L2Register's finalIndex.

Link copied to clipboard
open override fun instructionWasAdded(manifest: L2ValueManifest)

This is an operand of the given instruction, which was just added to its basic block. Its instruction was just set.

Link copied to clipboard
fun instructionWasAddedForMakeImmutable(sourceSemanticValue: L2SemanticValue, manifest: L2ValueManifest)

This operand is a write of an L2_MAKE_IMMUTABLE operation. The manifest has already had boxed definitions for the synonym removed from it, even if it left the definition list empty.

Link copied to clipboard
fun instructionWasAddedForMove(sourceSemanticValue: L2SemanticValue, manifest: L2ValueManifest)

This operand is a write of a move-like operation. Make the semantic value a synonym of the given L2ReadOperand's semantic value.

Link copied to clipboard
open override fun instructionWasInserted(newInstruction: L2Instruction)

This is an operand of the given instruction, which was just inserted into its basic block as part of an optimization pass.

Link copied to clipboard
open override fun instructionWasRemoved()

This is an operand of the given instruction, which was just removed from its basic block.

Link copied to clipboard
open fun onlySemanticValue(): L2SemanticValue

Answer this write's sole L2SemanticValue, failing if there isn't exactly one.

Link copied to clipboard
fun pickSemanticValue(): L2SemanticValue

Choose an arbitrary one of the L2SemanticValues that this operand writes.

Link copied to clipboard
open override fun postOptimizationCleanup()

Now that chunk optimization has completed, remove information from this instruction that will no longer be needed in the finished chunk. Note that during subsequent inlining of this chunk at a call site, the type and synonym information will be reconstructed without too much cost.

Link copied to clipboard
fun register(): L2BoxedRegister

Answer the register that is to be written.

Link copied to clipboard
fun registerString(): String

Answer a String that describes this operand for debugging.

Link copied to clipboard
open override fun replaceRegisters(registerRemap: Map<L2Register, L2Register>, theInstruction: L2Instruction)

Replace occurrences in this operand of each register that is a key of this map with the register that is the corresponding value. Do nothing to registers that are not keys of the map. Update all secondary structures, such as the instruction's source/destination collections.

Link copied to clipboard
fun restriction(): TypeRestriction

Answer this write's TypeRestriction.

Link copied to clipboard
fun retroactivelyIncludeSemanticValue(newSemanticValue: L2SemanticValue)

Add the given L2SemanticValue to this write operand's set of semantic values. DO NOT update any other structures to reflect this change, as this is the caller's responsibility.

Link copied to clipboard
fun semanticValues(): Set<L2SemanticValue>

Answer this write's immutable set of L2SemanticValues.

Link copied to clipboard
open fun setInstruction(theInstruction: L2Instruction?)

Set the instructionOrNull field.

Link copied to clipboard
open override fun toString(): String
Link copied to clipboard
open fun transformEachRead(transformer: (L2ReadOperand<*>) -> L2ReadOperand<*>): L2Operand

Transform each L2ReadOperand through the given lambda, producing either a new L2Operand of the same type, or the receiver.

Properties

Link copied to clipboard
val instruction: L2Instruction

Answer the L2Instruction containing this operand.

Link copied to clipboard
val instructionHasBeenEmitted: Boolean

Answer whether this write operand has been written yet as the destination of some instruction.

Link copied to clipboard
val isMisconnected: Boolean

Answer whether this operand is misconnected to its L2Instruction.

Link copied to clipboard
open override val operandType: L2OperandType

Answer this operand's L2OperandType.

Link copied to clipboard
open override val registerKind: L2Register.RegisterKind

Answer the RegisterKind of register that is written by this L2WriteOperand.