Package it.unive.lisa.symbolic.value

Class HeapLocation

java.lang.Object

it.unive.lisa.symbolic.SymbolicExpression

it.unive.lisa.symbolic.value.ValueExpression

it.unive.lisa.symbolic.value.Identifier

it.unive.lisa.symbolic.value.HeapLocation

All Implemented Interfaces:

ScopedObject<SymbolicExpression>

public class HeapLocation
extends Identifier

An identifier of a synthetic program variable that represents a resolved memory location.

Constructor Summary

Constructors

Constructor	Description
HeapLocation(Type staticType, java.lang.String name, boolean weak, CodeLocation location)	Builds the heap location.

Method Summary

Modifier and Type	Method	Description
<T> T	accept(ExpressionVisitor<T> visitor, java.lang.Object... params)	Accepts an ExpressionVisitor, visiting this expression recursively.
boolean	canBeScoped()	Yields true if a call to SymbolicExpression.pushScope(ScopeToken) on this identifier yields a new OutOfScopeIdentifier associated with the given scope, that can then be removed by SymbolicExpression.popScope(ScopeToken).
boolean	equals(java.lang.Object obj)
int	hashCode()
Identifier	lub(Identifier other)	Yields the least upper bounds between two identifiers.
SymbolicExpression	popScope(ScopeToken token)	Pops the scope identified by the given token from the expression.
SymbolicExpression	pushScope(ScopeToken token)	Pushes a new scope, identified by the give token, in the expression.
java.lang.String	toString()

Methods inherited from class it.unive.lisa.symbolic.value.Identifier

addAnnotation, getAnnotations, getName, isScopedByCall, isWeak, mightNeedRewriting

Methods inherited from class it.unive.lisa.symbolic.value.ValueExpression

removeNegations

Methods inherited from class it.unive.lisa.symbolic.SymbolicExpression

getCodeLocation, getStaticType

Methods inherited from class java.lang.Object

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

Constructor Detail

HeapLocation

public HeapLocation(Type staticType,
                    java.lang.String name,
                    boolean weak,
                    CodeLocation location)

Builds the heap location.

Parameters:

staticType - the static type of this expression

name - the name of the location

weak - whether or not this identifier is weak, meaning that it should only receive weak assignments

location - the code location of the statement that has generated this expression

Method Detail

toString

public java.lang.String toString()

Specified by:

toString in class SymbolicExpression

hashCode

public int hashCode()

Overrides:

hashCode in class Identifier

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class Identifier

lub

public Identifier lub(Identifier other)
               throws SemanticException

Description copied from class: Identifier

Yields the least upper bounds between two identifiers.

Overrides:

lub in class Identifier

Parameters:

other - the other identifier

Returns:

the least upper bounds between two identifiers.

Throws:

SemanticException - if this and other are not equal.

canBeScoped

public boolean canBeScoped()

Description copied from class: Identifier

Yields true if a call to SymbolicExpression.pushScope(ScopeToken) on this identifier yields a new OutOfScopeIdentifier associated with the given scope, that can then be removed by SymbolicExpression.popScope(ScopeToken). If this method returns false, then SymbolicExpression.pushScope(ScopeToken) and SymbolicExpression.popScope(ScopeToken) will always return this identifier instead.

Specified by:

canBeScoped in class Identifier

Returns:

true if that condition holds

pushScope

public SymbolicExpression pushScope(ScopeToken token)

Description copied from class: SymbolicExpression

Pushes a new scope, identified by the give token, in the expression. This causes all Identifiers where Identifier.canBeScoped() holds to become OutOfScopeIdentifiers associated with the given token.

Specified by:

pushScope in interface ScopedObject<SymbolicExpression>

Specified by:

pushScope in class SymbolicExpression

Parameters:

token - the token identifying the scope to push

Returns:

a copy of this expression where the local variables have gone out of scope

popScope

public SymbolicExpression popScope(ScopeToken token)
                            throws SemanticException

Description copied from class: SymbolicExpression

Pops the scope identified by the given token from the expression. This causes all the invisible variables (i.e. OutOfScopeIdentifiers) mapped to the given scope to become visible (e.g. Variables) again. Note that invoking this method on Identifiers where Identifier.canBeScoped() holds will return null if (i) the identifier is not scoped, or (ii) the identifier is scoped by a different token.

Specified by:

popScope in interface ScopedObject<SymbolicExpression>

Specified by:

popScope in class SymbolicExpression

Parameters:

token - the token of the scope to be restored

Returns:

a copy of this expression where the local variables associated with the given scope are visible again

Throws:

SemanticException - if an error occurs during the computation

accept

public <T> T accept(ExpressionVisitor<T> visitor,
                    java.lang.Object... params)
             throws SemanticException

Description copied from class: SymbolicExpression

Accepts an ExpressionVisitor, visiting this expression recursively.

Specified by:

accept in class SymbolicExpression

Type Parameters:

T - the type of value produced by the visiting callbacks

Parameters:

visitor - the visitor

params - additional optional parameters to pass to each visiting callback

Returns:

the value produced by the visiting operation

Throws:

SemanticException - if an error occurs during the visiting