IDInstruction

Adjust this instruction's IR size. Dangerous method. Make sure to ensure CFG consistency if this instruction is part of a CFG.

Copy this element. This operation can be seen as a custom duplication; the resulting element may not be of the same type as this element.

Copy all base fields, that is all fields but the opcode and operands of the source instruction to this instruction.

Count the number of times the provided variable is used (read) by this instruction.

Example (ASSIGN opcode): x = y * (y + z) => x is not used; y is used twice; z is used once

Deep copy of this instruction.

Duplicate this instruction with the intent to replace the source instruction. The offset and size of the source instruction are copied over to the newly created instruction.

Convenience method: evaluate the IR instruction using the provided set a variable values.

Retrieve the IR method context to which this instruction belongs. The method context holds all information regarding a current method decompilation. It is also a factory to create more IDInstruction objects.

Get the identifier defined (written) by this method, if there is one. Only IR_ASSIGN and IR_STORE_EXCEPTION may define (write) identifiers.

Get the condition predicate (if the instruction is a JCOND).

IR offsets are 32-bit integers; they can be safely cast to int.

Retrieve the end offset (exclusive) of this instruction

Get this instruction opcode.

Get the first operand. May be null if the opcode does not specify one. Refer to getOpcode() and DOpcodeType.

Get the second operand. May be null if the opcode does not specify one. Refer to getOpcode() and DOpcodeType.

Get the variables used (read) by this instruction.

Determine whether the right-side of assignment statements may have side-effects.

This method is not fail-safe, it works on a best-effort basis. Refer to hasSideEffects(IDMethodContext, boolean) for more information.@return

Determine whether the used components of the statement may have side-effects.

This method is not fail-safe, it works on a best-effort basis. Refer to hasSideEffects(IDMethodContext, boolean) for more information.

This dangerous method allows changing an IR instruction into a different one, while keeping metadata (e.g. offset, size, etc.) intact. If possible, use one of the transformXxx instructions instead.

Replace the variable defined by this statement (if there is any).

Deep replace all matching used variables of this instruction. The replacement expression is duplicated to avoid reuse. Defined identifiers (if any) are not replaced.

Update the branch target for unconditional and conditional jumps only. This function fails for all other opcodes, including switches.

Update the instruction context. It is important to update the context when transferring the instructions from a CFG (from context A) to another CFG (of contextB).

Set this instruction's IR offset. Dangerous method. Make sure to ensure CFG consistency if this instruction is part of a CFG.

Change the instruction opcode. This method is dangerous. Instruction operands may require an update as well.

Change the instruction first operand. This method is dangerous. Other instruction attributes may require an update as well.

Change the instruction second operand. This method is dangerous. Other instruction attributes may require an update as well.

Set this instruction's IR size. Dangerous method. Make sure to ensure CFG consistency if this instruction is part of a CFG.

Transform a conditional jump instruction to a conditional-predicate assignment. It is the caller's responsibility to verify that the instruction is a JCOND.

 IF pred GOTO target ==> dst = pred
 

Transform a conditional jump instruction to a jump. It is the caller's responsibility to verify that the instruction is a JCOND.

 IF pred GOTO target ==> GOTO target
 

Transform a single-case switch into a conditional jump.

 SWITCH(VAR) {
 CASE X: GOTO target;
 }
 // fall-through
 =>
 IF VAR==X GOTO target;
 // fall-through
 

Transform any instruction to a jump, and update the jump target.

Transform any instruction to a jump, and update the jump target.

Transform any instruction to a NOP.

Update the targets of a branching instruction. This method has no effect on IR opcodes other than JUMP, JCOND, and SWITCH.

Update the targets of a branching instruction. This method has no effect on IR opcodes other than JUMP, JCOND, and SWITCH.

Verify this instruction.

Currently, this method verifies that the instruction operands match the current opcode specifications (see DOpcodeType).

Visit this instruction and its constituents. The visit is made depth-first, pre-order, and parents are recorded. (Refer to IVisitResults for details.)

Same as visitInstructionPreOrder. Replacements must be reported (refer to visitDepthPre(IDVisitor) for details).

Visit this instruction and its constituents. The visit is made depth-first, pre-order, and parents are recorded. (Refer to IVisitResults for details.)

Same as visitInstructionPreOrder. Replacements must be reported (refer to visitDepthPre(IDVisitor) for details).

Visit this instruction and its constituents. The visit is made depth-first, post-order, and parents are recorded. (Refer to IVisitResults for details.)

Replacements need not be reported.

Visit this instruction and its constituents. The visit is made depth-first, pre-order, and parents are recorded. (Refer to IVisitResults for details.)

Replacements must be reported (refer to visitDepthPre(IDVisitor) for details).

Update the instruction offset.

Update the instruction size.