Class UnarySideEffect

java.lang.Object

com.ibm.wala.fixpoint.AbstractOperator<PointsToSetVariable>

com.ibm.wala.fixpoint.UnaryOperator<PointsToSetVariable>

com.ibm.wala.ipa.callgraph.propagation.UnarySideEffect

All Implemented Interfaces:

FixedPointConstants

Direct Known Subclasses:

PropagationCallGraphBuilder.ArrayLoadOperator, PropagationCallGraphBuilder.ArrayStoreOperator, PropagationCallGraphBuilder.GetFieldOperator, PropagationCallGraphBuilder.PutFieldOperator

public abstract class UnarySideEffect
extends UnaryOperator<PointsToSetVariable>

A SideEffect is a constraint which carries a points-to-set which is def'fed or used in created constraints.

The side effect doesn't actually def or use the fixedSet itself ... rather, the side effect creates new constraints that def or use the fixed set.

A "load" operator generates defs of the fixed set. A "store" operator generates uses of the fixed set.

Field Summary

Fields inherited from interface FixedPointConstants

CHANGED, CHANGED_AND_FIXED, CHANGED_MASK, FIXED_MASK, NOT_CHANGED, NOT_CHANGED_AND_FIXED, SIDE_EFFECT_MASK

Modifier and Type	Field	Description
static final byte	CHANGED	A return value which indicates that a lhs has changed, and the statement might need to be evaluated again.
static final byte	CHANGED_AND_FIXED	A return value which indicates that lhs has changed, and the statement need not be evaluated again.
static final int	CHANGED_MASK	The bit-mask which defines the "CHANGED" flag
static final int	FIXED_MASK	The bit-mask which defines the "FIXED" flag
static final byte	NOT_CHANGED	A return value which indicates that lhs has not changed, and the statement might need to be evaluated again.
static final byte	NOT_CHANGED_AND_FIXED	A return value which indicates that lhs has not changed, and the statement need not be evaluated again.
static final int	SIDE_EFFECT_MASK	The bit-mask which defines the "SIDE EFFECT" flag

Constructor Summary

Constructors

Constructor	Description
UnarySideEffect(PointsToSetVariable fixedSet)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
abstract byte	evaluate(PointsToSetVariable rhs)
final byte	evaluate(PointsToSetVariable lhs, PointsToSetVariable rhs)	Evaluate this equation, setting a new value for the left-hand side.
int	hashCode()
protected abstract boolean	isLoadOperator()	A "load" operator generates defs of the fixed set.
void	replaceFixedSet(PointsToSetVariable p)	Update the fixed points-to-set associated with this side effect.

Methods inherited from class UnaryOperator

evaluate, isIdentity, makeEquation

Modifier and Type	Method	Description
byte	evaluate(PointsToSetVariable lhs, PointsToSetVariable[] rhs)	Evaluate this equation, setting a new value for the left-hand side.
boolean	isIdentity()
UnaryStatement<PointsToSetVariable>	makeEquation(PointsToSetVariable lhs, PointsToSetVariable rhs)	Create an equation which uses this operator Override in subclasses for efficiency.

Methods inherited from class AbstractOperator

toString

Modifier and Type	Method	Description
abstract String	toString()

Methods inherited from class Object

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

Constructor Details

UnarySideEffect

public UnarySideEffect(PointsToSetVariable fixedSet)

Method Details

evaluate

public final byte evaluate(PointsToSetVariable lhs,
 PointsToSetVariable rhs)

Description copied from class: UnaryOperator

Evaluate this equation, setting a new value for the left-hand side.

Specified by:

evaluate in class UnaryOperator<PointsToSetVariable>

Returns:

a constant defined by FixedPointConstants that reflects whether the lhs value changed

evaluate

public abstract byte evaluate(PointsToSetVariable rhs)

equals

public boolean equals(Object o)

Specified by:

equals in class AbstractOperator<PointsToSetVariable>

hashCode

public int hashCode()

Specified by:

hashCode in class AbstractOperator<PointsToSetVariable>

isLoadOperator

protected abstract boolean isLoadOperator()

A "load" operator generates defs of the fixed set. A "store" operator generates uses of the fixed set.

replaceFixedSet

public void replaceFixedSet(PointsToSetVariable p)

Update the fixed points-to-set associated with this side effect.