ICCompound

implements ICStatement

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

Known Indirect Subclasses

ICBlock, ICConditionalStatement, ICDoWhileStm, ICForStm, ICGenericBreakable, ICGenericLoop, ICGenericWhileLoop, ICIfStm, ICSwitchStm, ICWhileStm

Class Overview

C AST interface to represent compound statements.

Compound statements contain more statements, laid out in blocks. A block is the simplest type of compound. Compounds include if-conditionals, loops, switches, etc.

Summary

Public Methods
abstract ICCompound	duplicate() Deep duplication of the element.
abstract List<ICStatement>	generateFlatList() Generate a flat list of AST and pseudo-AST elements that make up this block.
abstract List<ICBlock>	getBlocks() Retrieve the list of blocks (not elements) that are used to define that compound element.
abstract boolean	insertAt(long target_offset, ICStatement insert_stm) Insert a statement at a particular offset within the AST.
abstract void	reset() Reset the compound.

[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.

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

Public Methods

public abstract ICCompound duplicate ()

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

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

public abstract List<ICStatement> generateFlatList ()

Generate a flat list of AST and pseudo-AST elements that make up this block. This function allows the caller to get a flat representation of the AST, much like a programmer would view a source code. Note that the statements returned can be pseudo statements, ie, they're not real statements. For example, a flat view of a conditional block would return pseudo-statements to represent the "if" line, the "else if" lines, and the "else" line.

Returns

a list of statements and pseudo-statements

public abstract List<ICBlock> getBlocks ()

Retrieve the list of blocks (not elements) that are used to define that compound element.

public abstract boolean insertAt (long target_offset, ICStatement insert_stm)

Insert a statement at a particular offset within the AST. This function recurses down the AST tree, inside the blocks, to find the exact location where the statement should be inserted.

public abstract void reset ()

Reset the compound. Internal use.

Interfaces

Classes

Enums