org.jruby.ir.instructions

Class ModuleVersionGuardInstr

java.lang.Object

org.jruby.ir.instructions.Instr

org.jruby.ir.instructions.TwoOperandInstr

org.jruby.ir.instructions.ModuleVersionGuardInstr

All Implemented Interfaces:

FixedArityInstr

public class ModuleVersionGuardInstr
extends TwoOperandInstr
implements FixedArityInstr

This instruction will be generated whenever speculative optimizations are performed based on assuming that an object's metaclass is C (as determined by the version number of C -- where the version number changes every time C's class structure changes).

Field Summary

Fields inherited from class org.jruby.ir.instructions.Instr

EMPTY_OPERANDS

Constructor Summary

Constructors

Constructor and Description
ModuleVersionGuardInstr(RubyModule module, int expectedVersion, Operand candidateObj, Label failurePathLabel)

Method Summary

Methods

Modifier and Type	Method and Description
Instr	clone(CloneInfo ii) Clone the instruction for use in an inlining context (either when a scope is inlined into another scope, or when a block has to be cloned because its associated call belongs to an inlined scope).
Operand	getCandidateObject() The object whose metaclass token has to be verified
int	getExpectedVersion()
Label	getFailurePathLabel() Where to jump if the version assumption fails?
RubyModule	getModule()
int	interpretAndGetNewIPC(ThreadContext context, DynamicScope currDynScope, StaticScope currScope, IRubyObject self, Object[] temp, int ipc)
String[]	toStringNonOperandArgs()
void	visit(IRVisitor visitor)

Methods inherited from class org.jruby.ir.instructions.TwoOperandInstr

getOperand1, getOperand2, getOperands, setOperand, setOperand1, setOperand2

Methods inherited from class org.jruby.ir.instructions.Instr

canBeDeletedFromScope, canRaiseException, cloneOperands, computeScopeFlags, encode, getIPC, getOperation, getRPC, getUsedVariables, hasSideEffects, interpret, isDead, isDeletable, markDead, renameVars, setIPC, setRPC, simplifyAndGetResult, simplifyOperands, toString, transfersControl

Methods inherited from class java.lang.Object

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

Constructor Detail

ModuleVersionGuardInstr

public ModuleVersionGuardInstr(RubyModule module,
                       int expectedVersion,
                       Operand candidateObj,
                       Label failurePathLabel)

Method Detail

getCandidateObject

public Operand getCandidateObject()

The object whose metaclass token has to be verified

getFailurePathLabel

public Label getFailurePathLabel()

Where to jump if the version assumption fails?

getModule

public RubyModule getModule()

getExpectedVersion

public int getExpectedVersion()

toStringNonOperandArgs

public String[] toStringNonOperandArgs()

Overrides:

toStringNonOperandArgs in class Instr

clone

public Instr clone(CloneInfo ii)

Description copied from class: Instr

Clone the instruction for use in an inlining context (either when a scope is inlined into another scope, or when a block has to be cloned because its associated call belongs to an inlined scope). This might renaming variables and labels to eliminate naming conflicts. The implementation might vary on the cloning mode.

Specified by:

clone in class Instr

Parameters:

ii - This object manages renaming of variables and labels, handles args and return values.

Returns:

a new instruction that can be used in the target scope.

interpretAndGetNewIPC

public int interpretAndGetNewIPC(ThreadContext context,
                        DynamicScope currDynScope,
                        StaticScope currScope,
                        IRubyObject self,
                        Object[] temp,
                        int ipc)

Overrides:

interpretAndGetNewIPC in class Instr

visit

public void visit(IRVisitor visitor)

Overrides:

visit in class Instr