com.ibm.wala.ssa
Class SSAInvokeInstruction

java.lang.Object
  com.ibm.wala.ssa.SSAInstruction
      com.ibm.wala.ssa.SSAAbstractInvokeInstruction
          com.ibm.wala.ssa.SSAInvokeInstruction

All Implemented Interfaces:

IInstruction, IInvokeInstruction

public class SSAInvokeInstruction
extends SSAAbstractInvokeInstruction

Nested Class Summary

Nested classes/interfaces inherited from class com.ibm.wala.ssa.SSAInstruction

SSAInstruction.IVisitor, SSAInstruction.Visitor

Nested classes/interfaces inherited from interface com.ibm.wala.shrikeBT.IInvokeInstruction

IInvokeInstruction.Dispatch, IInvokeInstruction.IDispatch

Field Summary

Fields inherited from class com.ibm.wala.ssa.SSAAbstractInvokeInstruction

exception, site

Constructor Summary

SSAInvokeInstruction(int[] params, int exception, CallSiteReference site)
Constructor InvokeInstruction.

SSAInvokeInstruction(int result, int[] params, int exception, CallSiteReference site)

Method Summary

static void	assertParamsKosher(int result, int[] params, CallSiteReference site)
SSAInstruction	copyForSSA(int[] defs, int[] uses) This method is meant to be used during SSA conversion for an IR that is not in SSA form.
java.util.Collection<TypeReference>	getExceptionTypes() This method should never return null.
int	getNumberOfParameters()
int	getNumberOfReturnValues()
int	getNumberOfUses() Method getNumberOfUses.
int	getReturnValue(int i)
int	getUse(int j) Method getUse.
int	hashCode()
void	visit(SSAInstruction.IVisitor v) Apply an IVisitor to this instruction.

Methods inherited from class com.ibm.wala.ssa.SSAAbstractInvokeInstruction

getCallSite, getDeclaredResultType, getDeclaredTarget, getDef, getDef, getException, getInvocationCode, getNumberOfDefs, getProgramCounter, getReceiver, hasDef, isDispatch, isFallThrough, isPEI, isSpecial, isStatic, toString

Methods inherited from class com.ibm.wala.ssa.SSAInstruction

equals, getValueString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SSAInvokeInstruction

public SSAInvokeInstruction(int result,
                            int[] params,
                            int exception,
                            CallSiteReference site)

SSAInvokeInstruction

public SSAInvokeInstruction(int[] params,
                            int exception,
                            CallSiteReference site)

Constructor InvokeInstruction. This case for void return values

Method Detail

copyForSSA

public SSAInstruction copyForSSA(int[] defs,
                                 int[] uses)

Description copied from class: SSAInstruction

This method is meant to be used during SSA conversion for an IR that is not in SSA form. It creates a new SSAInstruction of the same type as the receiver, with a combination of the receiver's uses and defs and those from the method parameters. In particular, if the 'defs' parameter is null, then the new instruction has the same defs as the receiver. If 'defs' is not null, it must be an array with a size equal to the number of defs that the receiver instruction has. In this case, the new instruction has defs taken from the array. The uses of the new instruction work in the same way with the 'uses' parameter. Note that this only applies to CAst-based IR translation, since Java bytecode-based IR generation uses a different SSA construction mechanism. TODO: this is kind of arcane? Move this out into CAst?

Specified by:

copyForSSA in class SSAInstruction

assertParamsKosher

public static void assertParamsKosher(int result,
                                      int[] params,
                                      CallSiteReference site)
                               throws java.lang.IllegalArgumentException

Throws:

java.lang.IllegalArgumentException

visit

public void visit(SSAInstruction.IVisitor v)

Description copied from class: SSAInstruction

Apply an IVisitor to this instruction. We invoke the appropriate IVisitor method according to the type of this instruction.

Specified by:

visit in class SSAInstruction

Throws:

java.lang.IllegalArgumentException - if v is null

See Also:

SSAInstruction.visit(IVisitor)

getNumberOfUses

public int getNumberOfUses()

Description copied from class: SSAInstruction

Method getNumberOfUses.

Overrides:

getNumberOfUses in class SSAInstruction

Returns:

int

See Also:

SSAInstruction.getNumberOfUses()

getNumberOfParameters

public int getNumberOfParameters()

Specified by:

getNumberOfParameters in class SSAAbstractInvokeInstruction

getNumberOfReturnValues

public int getNumberOfReturnValues()

Specified by:

getNumberOfReturnValues in class SSAAbstractInvokeInstruction

getReturnValue

public int getReturnValue(int i)

Specified by:

getReturnValue in class SSAAbstractInvokeInstruction

getUse

public int getUse(int j)

Description copied from class: SSAInstruction

Method getUse.

Overrides:

getUse in class SSAInstruction

Returns:

value number representing the jth use in this instruction. -1 means TOP (i.e., the value doesn't matter)

See Also:

SSAInstruction.getUse(int)

hashCode

public int hashCode()

Specified by:

hashCode in class SSAInstruction

getExceptionTypes

public java.util.Collection<TypeReference> getExceptionTypes()

Description copied from class: SSAInstruction

This method should never return null.

Specified by:

getExceptionTypes in class SSAInstruction

Returns:

the set of exception types that an instruction might throw ... disregarding athrows and invokes.