com.google.security.zynamics.binnavi.API.disassembly.BasicBlock Class Reference

Inherits com::google::security::zynamics::binnavi::API::disassembly::IGraphNode< BasicBlock >, and com::google::security::zynamics::binnavi::APIHelpers::ApiObject< IBlockNode >.

List of all members.

Public Member Functions
Address	getAddress ()
List< BasicBlock >	getChildren ()
String	getComment ()
List< Instruction >	getInstructions ()
Function	getParentFunction ()
List< BasicBlock >	getParents ()
ReilGraph	getReilCode () throws InternalTranslationException
Iterator< Instruction >	iterator ()
String	toString ()

---

Detailed Description

Basic blocks are one of the two elements that can be found in FlowGraph objects.

The structure of basic blocks is immutable. If you want to modify basic blocks it is necessary to convert the function that contains the basic blocks into a View first and to modify the corresponding code nodes in the view.

---

Member Function Documentation

Address com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getAddress

(

)

Returns the address of the basic block. This address equals the address of the first instruction in the basic block.

Returns:

The address of the basic block.

List<BasicBlock> com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getChildren

(

)

Returns the children of the basic block. The children of a basic block are exactly the basic block where control flow can continue after the last instruction of the basic block was executed.

Returns:

A list of basic blocks that are child blocks of the basic block.

String com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getComment

(

)

Returns the comment of the basic block. This comment is displayed as the global comment of code nodes in views.

Returns:

The comment of the basic block.

List<Instruction> com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getInstructions

(

)

Returns a list of instructions inside the basic block.

Returns:

The instructions of the basic block.

Function com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getParentFunction

(

)

Returns the parent function of the basic block.

Returns:

The parent function of the basic block.

List<BasicBlock> com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getParents

(

)

Returns the parents of the basic block. The parents of the basic block are exactly those basic blocks that can be executed right before the first instruction of the basic block is executed.

Returns:

A list of basic blocks that are parent blocks of the basic block.

ReilGraph com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.getReilCode

(

)

throws InternalTranslationException

Converts the basic block to REIL code.

Using this function over manual translation via ReilTranslator has the advantage that REIL translation results are automatically cached. Subsequent uses of this function requires no additional re-translation of the basic block provided that nothing relevant (like added/removed code nodes) changed.

Returns:

The REIL representation of the instruction.

Exceptions:

InternalTranslationException

Thrown if the REIL translation failed.

Iterator<Instruction> com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.iterator

(

)

Can be used to iterate over all instructions in the basic block.

Returns:

An iterator to iterate over the instructions of the basic block.

String com.google.security.zynamics.binnavi.API.disassembly.BasicBlock.toString

(

)

Returns a string representation of the basic block.

Returns:

A string representation of the basic block.