Package it.unive.lisa.program.cfg.statement

Class Throw

java.lang.Object

it.unive.lisa.program.cfg.statement.Statement

it.unive.lisa.program.cfg.statement.UnaryStatement

it.unive.lisa.program.cfg.statement.Throw

All Implemented Interfaces:

ProgramPoint, CodeElement, CodeNode<CFG,Statement,Edge>, Node<CFG,Statement,Edge>, java.lang.Comparable<Statement>

public class Throw
extends UnaryStatement

A statement that raises an error, stopping the execution of the current CFG and propagating the error to among the call chain.

Field Summary

Fields inherited from class it.unive.lisa.program.cfg.statement.Statement

offset

Constructor Summary

Constructors

Constructor	Description
Throw(CFG cfg, CodeLocation location, Expression expression)	Builds the throw, raising expression as error, happening at the given location in the program.

Method Summary

Modifier and Type	Method	Description
<A extends AbstractState<A,H,V,T>,H extends HeapDomain<H>,V extends ValueDomain<V>,T extends TypeDomain<T>> AnalysisState<A,H,V,T>	semantics(AnalysisState<A,H,V,T> entryState, InterproceduralAnalysis<A,H,V,T> interprocedural, StatementStore<A,H,V,T> expressions)	Computes the semantics of the statement, expressing how semantic information is transformed by the execution of this statement.
boolean	stopsExecution()	Whether or not this statement stops the execution of the containing cfg, either by throwing an error or returning a value.
boolean	throwsError()	Whether or not this statement throws an error, halting the normal execution of the containing cfg.
java.lang.String	toString()

Methods inherited from class it.unive.lisa.program.cfg.statement.UnaryStatement

accept, equals, getExpression, getStatementEvaluatedBefore, hashCode, setOffset

Methods inherited from class it.unive.lisa.program.cfg.statement.Statement

compareTo, getCFG, getEvaluationPredecessor, getLocation, getOffset

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface it.unive.lisa.program.cfg.ProgramPoint

getProgram

Constructor Detail

Throw

public Throw(CFG cfg,
             CodeLocation location,
             Expression expression)

Builds the throw, raising expression as error, happening at the given location in the program.

Parameters:

cfg - the cfg that this statement belongs to

location - the location where the expression is defined within the program

expression - the expression to raise as error

Method Detail

toString

public final java.lang.String toString()

Specified by:

toString in class Statement

stopsExecution

public boolean stopsExecution()

Description copied from class: Statement

Whether or not this statement stops the execution of the containing cfg, either by throwing an error or returning a value. To distinguish error-raising halting statements and normal ones, use Statement.throwsError().

Overrides:

stopsExecution in class Statement

Returns:

true only if that condition holds

throwsError

public boolean throwsError()

Description copied from class: Statement

Whether or not this statement throws an error, halting the normal execution of the containing cfg.

Overrides:

throwsError in class Statement

Returns:

true only if that condition holds

semantics

public <A extends AbstractState<A,H,V,T>,H extends HeapDomain<H>,V extends ValueDomain<V>,T extends TypeDomain<T>> AnalysisState<A,H,V,T> semantics(AnalysisState<A,H,V,T> entryState,
                                                                                                                                                                                                          InterproceduralAnalysis<A,H,V,T> interprocedural,
                                                                                                                                                                                                          StatementStore<A,H,V,T> expressions)
                                                                                                                                                                                                   throws SemanticException

Description copied from class: Statement

Computes the semantics of the statement, expressing how semantic information is transformed by the execution of this statement. This method is also responsible for recursively invoking the Statement.semantics(AnalysisState, InterproceduralAnalysis, StatementStore) of each nested Expression, saving the result of each call in expressions.

Specified by:

semantics in class Statement

Type Parameters:

A - the type of AbstractState

H - the type of the HeapDomain

V - the type of the ValueDomain

T - the type of TypeDomain

Parameters:

entryState - the entry state that represents the abstract values of each program variable and memory location when the execution reaches this statement

interprocedural - the interprocedural analysis of the program to analyze

expressions - the cache where analysis states of intermediate expressions must be stored

Returns:

the AnalysisState representing the abstract result of the execution of this statement

Throws:

SemanticException - if something goes wrong during the computation