ICStatement

implements ICElement

com.pnfsoftware.jeb.core.units.code.asm.decompiler.ast.ICStatement

Known Indirect Subclasses

ICAssignment, ICBlock, ICBreak, ICCall, ICCompound, ICConditionalStatement, ICContinue, ICControlBreaker, ICCustomStatement, ICDecl, ICDoWhileStm, ICForStm, ICGenericBreakable, ICGenericLoop, ICGenericWhileLoop, and 9 others.

ICAssignment	C AST interface to represent assignments.
ICBlock	C AST interface to represent a sequence of `statements`.
ICBreak	C AST interface to represent a `break` statement.
ICCall	C AST interface to represent a routine call.
ICCompound	C AST interface to represent compound statements.
ICConditionalStatement	Base class for CAST conditional statements (if, switch).
ICContinue	C AST interface to represent a `continue` statement.
ICControlBreaker	C AST interface for flow breaker (break, continue, goto).
ICCustomStatement	A custom C statement.
ICDecl	C AST interface representing the declaration of a `typed` `identifier`.
ICDoWhileStm	C AST interface to represent a `do-while` loop statement.
ICForStm	C AST interface used to represent a standard for loop statement.
ICGenericBreakable	Super interface for C AST breakable compounds (loops, switches).
ICGenericLoop	Super interface for C AST loops (for, do-while, while).
ICGenericWhileLoop	C AST interface for while-like loops (while, do-while).
ICGoto	C AST interface to represent a "goto" statement.
ICIfStm	C AST interface to represent a conditional "if" statement.
ICJumpFar	C AST element representing a "long jump".
ICLabel	C AST label interfaces are immutable AST elements created by an `ICLabelFactory`.
ICReturn	C AST interface to represent return statements of methods.
ICSwitchStm	C AST interface to represent `switch` statements.
ICTerminalStatement	High-level C AST interface extended by Return and Throw statements.
ICThrow	C AST interface to represent throw statements.
ICWhileStm	C AST interface to represent `while` loop statements.

Class Overview

Base interface for C AST elements that represent statements in a code block.

Summary

Public Methods
abstract ICStatement	duplicate() Deep duplication of the element.
abstract long	getIntermediateOffset()
abstract void	setIntermediateOffset(long irOffset) Called by the code that converts the IR instructions to AST statements Optional for "artificial" AST elements.

[Expand]

Inherited Methods

From interface com.pnfsoftware.jeb.core.units.code.asm.decompiler.ast.ICElement

abstract void	addPhysicalOffset(Long offset)
abstract void	addPhysicalOffsets(Collection<Long> offsets)
abstract ICElement	duplicate() Deep duplication of the element.
abstract Long	evaluate(CMethodState state, CEnvironment environment)
abstract String	format() Generate a full-form text version of this element.
abstract void	generate(COutputSink out) Generate the visual representation of the AST element.
abstract Object	getData(Object key) Retrieve a piece of data attached to this AST element.
abstract CElementType	getElementType() This convenience method returns the type of C AST element held by this object.
abstract Long	getPhysicalOffset() Get the closest physical offset or address that matches this high-level pseudo-code element.
abstract Collection<Long>	getPhysicalOffsets() Get the physical offsets of instructions matching this AST element.
abstract List<ICElement>	getSubElements() Get the list of AST elements that constitute this AST element.
abstract boolean	replaceSubElement(ICElement oldElement, ICElement newElement) Replace one element by another one.
abstract void	setData(String key, Object value) Attach a piece of data to this AST element.
abstract void	setPhysicalOffsets(Collection<Long> offsets)
abstract String	toString() Generate a short-form text version of this element.
abstract boolean	visitDepthPost(ICVisitor visitor) Depth-first search, post-order visit of an expression tree or sub-tree.
abstract boolean	visitDepthPost(ICVisitor visitor, ICElement parent, CVisitResults results) Depth-first search, post-order visit of an expression tree or sub-tree.
abstract boolean	visitDepthPost(ICVisitor visitor, ICElement parent) Depth-first search, post-order visit of an expression tree or sub-tree.
abstract boolean	visitDepthPre(ICVisitor visitor, ICElement parent, CVisitResults results) Depth-first search, pre-order visit of an expression tree or sub-tree.
abstract boolean	visitDepthPre(ICVisitor visitor, ICElement parent) Depth-first search, pre-order visit of an expression tree or sub-tree.
abstract boolean	visitDepthPre(ICVisitor visitor) Depth-first search, pre-order visit of an expression tree or sub-tree.

Public Methods

public abstract ICStatement duplicate ()

Deep duplication of the element. Sub-elements are duplicated.

Note: ICClass, ICMethod, ICField, ICIdentifier, ICConstant, ICType and ICLabel are not duplicated.

public abstract long getIntermediateOffset ()

public abstract void setIntermediateOffset (long irOffset)

Called by the code that converts the IR instructions to AST statements
Optional for "artificial" AST elements.
The goal is to maintain a relationship between AST elements and the IR instructions that generated them. Ideally, the same relationship is maintained between IR instructions and machine code. This allows clients to establish correspondence between AST (source) and opcodes (assembly).

Parameters

irOffset	IR code first instruction offset for the statement

Interfaces

Classes

Enums