Gets the keyword arg (or representation of what might be holding keyword args). The result of this is passed into the other keyword arg instructions to get what those instrs are interested in. One intent of this result is that it can be mutable so it can toggle off keyword arg flags early in the method before any exceptions or side-effects in the method can occur. It also can remove key/value pairs as individual keyword instructions execute. After all individual instructions have executed anything left is either kwrest or an arity error.
<init>(org.jruby.ir.operands.Variable result, boolean hasRestArg, boolean acceptsKeywords)decode(org.jruby.ir.persistence.IRReaderDecoder d)acceptsKeywords()hasRestArg() · also: has_rest_argreceiveArg(org.jruby.runtime.ThreadContext context, org.jruby.runtime.builtin.IRubyObject self, org.jruby.runtime.DynamicScope currDynScope, org.jruby.parser.StaticScope currScope, Object[] temp, org.jruby.runtime.builtin.IRubyObject[] args, boolean ruby2keywords)| field | type | note |
|---|---|---|
| EMPTY_OPERANDS | Operand[] |
canBeDeletedFromScope(org.jruby.ir.interpreter.FullInterpreterContext fic)canRaiseException()computeScopeFlags(org.jruby.ir.IRScope scope, EnumSet<org.jruby.ir.IRFlags> flags)Does this instruction do anything the scope is interested in?
Returns: true if it modified the scope or set any flags.
isDead() · also: is_deadisDeletable() · also: is_deletableCan this instruction be deleted? LVA will preserve instructions based on whether operands (variables) are living but even if there are no living variables then the instruction itself may not be able to be removed during DCE for other reasons (like if it unconditionally has a side-effect)
dumpableFields()hasSideEffects() · also: has_side_effectsinterpret(org.jruby.runtime.ThreadContext context, org.jruby.parser.StaticScope currScope, org.jruby.runtime.DynamicScope currDynScope, org.jruby.runtime.builtin.IRubyObject self, Object[] temp)interpretAndGetNewIPC(org.jruby.runtime.ThreadContext context, org.jruby.runtime.DynamicScope currDynScope, org.jruby.parser.StaticScope currScope, org.jruby.runtime.builtin.IRubyObject self, Object[] temp, int ipc)markDead()simplifyOperands(org.jruby.ir.IRScope scope, Map<org.jruby.ir.operands.Operand,org.jruby.ir.operands.Operand> valueMap)This method takes as input a map of operands to their values, and outputs the result of this instruction. If the value map provides a value for any of the instruction's operands the expectation is that the operand will be replaced with the simplified value. It is not required that it do so -- code correctness is not compromised by failure to simplify.
| name | type | description |
|---|---|---|
| scope | org.jruby.ir.IRScope | where this instr exists |
| value_map | Map<org.jruby.ir.operands.Operand,org.jruby.ir.operands.Operand> | Mapping from operands to their simplified values |
Returns: simplified result / output of this instruction
toString()Instructions are meant to be in a machine-readable format so offline tooling can parse the debugging output. The format is: (result_op '=')? instr '(' (operand ',' )* operand? ';' (extra_arg ',')* extra_arg? ')' extra_arg can either be plain value or in a key: value format.
Returns: a String
toStringNonOperandArgs()transfersControl()setOperand(int i, org.jruby.ir.operands.Operand operand)