org.jruby.ir.operands

Class Operand

java.lang.Object

org.jruby.ir.operands.Operand

Direct Known Subclasses:

Array, AsString, Attribute, BacktickString, CompoundArray, CompoundString, CurrentScope, DataFlowConstants.Anything, DataFlowConstants.LatticeBottom, DataFlowConstants.LatticeTop, DynamicSymbol, Hash, ImmutableLiteral, IRException, Label, MethodHandle, ObjectClass, Range, Reference, Regexp, ScopeModule, Splat, StandardError, StringLiteral, SValue, UndefinedValue, Variable, WrappedIRClosure

public abstract class Operand
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static Operand[]	EMPTY_ARRAY

Constructor Summary

Constructors

Constructor and Description
Operand()

Method Summary

Modifier and Type	Method and Description
abstract void	addUsedVariables(java.util.List<Variable> l) Append the list of variables used in this operand to the input list -- force every operand to implement this because a missing implementation can cause bad failures.
boolean	canCopyPropagate() Can we replace every use of a variable 'v' that contains the value of this operand with the operand itself? This takes importance when there are at least two uses of 'v' within this scope.
abstract Operand	cloneForInlining(InlinerInfo ii)
Operand	fetchCompileTimeArrayElement(int index, boolean getSubArray)
Operand	getSimplifiedOperand(java.util.Map<Operand,Operand> valueMap, boolean force)
Operand	getValue(java.util.Map<Operand,Operand> valueMap)
boolean	hasKnownValue() Do we know the value of this operand at compile-time? If we do then it may be possible to constant propagate (one case: We also know it is also an ImmutableLiteral).
java.lang.Object	retrieve(ThreadContext context, IRubyObject self, DynamicScope currDynScope, java.lang.Object[] temp)
void	visit(IRVisitor visitor)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_ARRAY

public static final Operand[] EMPTY_ARRAY

Constructor Detail

Operand

public Operand()

Method Detail

hasKnownValue

public boolean hasKnownValue()

Do we know the value of this operand at compile-time? If we do then it may be possible to constant propagate (one case: We also know it is also an ImmutableLiteral).

Returns:

true if a known compile-time value.

canCopyPropagate

public boolean canCopyPropagate()

Can we replace every use of a variable 'v' that contains the value of this operand with the operand itself? This takes importance when there are at least two uses of 'v' within this scope. Ex: v = [1,2,3]; x = v; y = v In this case, we cannot replace the occurences of 'v' because we would then get x = [1,2,3]; y = [1,2,3] which would then result in two different array objects being constructed instead of a single one.

Returns:

true if it is safe to copy-propagate the operand.

getSimplifiedOperand

public Operand getSimplifiedOperand(java.util.Map<Operand,Operand> valueMap,
                                    boolean force)

getValue

public Operand getValue(java.util.Map<Operand,Operand> valueMap)

fetchCompileTimeArrayElement

public Operand fetchCompileTimeArrayElement(int index,
                                            boolean getSubArray)

addUsedVariables

public abstract void addUsedVariables(java.util.List<Variable> l)

Append the list of variables used in this operand to the input list -- force every operand to implement this because a missing implementation can cause bad failures.

cloneForInlining

public abstract Operand cloneForInlining(InlinerInfo ii)

retrieve

public java.lang.Object retrieve(ThreadContext context,
                                 IRubyObject self,
                                 DynamicScope currDynScope,
                                 java.lang.Object[] temp)

visit

public void visit(IRVisitor visitor)