Dexmaker 1.5 · org.droidparts.dexmaker.dx.rop.code.LocalVariableInfo

Modifier and Type	Field and Description
private final RegisterSpecSet[]	blockStarts `non-null;` array consisting of register sets representing the sets of variables already assigned upon entry to each block, where array indices correspond to block labels
private final RegisterSpecSet	emptySet `non-null;` `RegisterSpecSet` to use when indicating a block that has no locals; it is empty and immutable but has an appropriate max size for the method
private final HashMap<Insn, RegisterSpec>	insnAssignments `non-null;` map from instructions to the variable each assigns
private final int	regCount `>= 0;` the register count for the method

Access	Constructor and Description
public	LocalVariableInfo(RopMethod `non-null;` the method being represented by this instance method) Constructs an instance.

Method Summary

Modifier and Type	Method and Description
public void	addAssignment(Insn `non-null;` the instruction in question insn, RegisterSpec `non-null;` the associated register spec spec) Adds an assignment association for the given instruction and register spec.
public void	debugDump()
public RegisterSpec	Returns: `null-ok;` the named register being assigned, if any getAssignment(Insn `non-null;` instruction in question insn) Gets the named register being assigned by the given instruction, if previously stored in this instance.
public int	Returns: `>= 0;` the number of assignments getAssignmentCount() Gets the number of assignments recorded by this instance.
public RegisterSpecSet	Returns: `non-null;` the associated register set getStarts(int `>= 0;` the block label label) Gets the register set associated with the start of the block with the given label.
public RegisterSpecSet	Returns: `non-null;` the associated register set getStarts(BasicBlock `non-null;` the block in question block) Gets the register set associated with the start of the given block.
private RegisterSpecSet	Returns: `null-ok;` associated register set or `null` if there is none getStarts0(int `>= 0;` the block label label) Helper method, to get the starts for a label, throwing the right exception for range problems.
public boolean	Returns: `true` if the merge resulted in an actual change to the associated set (including storing one for the first time) or `false` if there was no change mergeStarts(int `>= 0;` the block label label, RegisterSpecSet `non-null;` the register set to merge into the start set for the block specs) Merges the given register set into the set for the block with the given label.
public RegisterSpecSet	Returns: `non-null;` the associated register set mutableCopyOfStarts(int `>= 0;` the block label label) Gets a mutable copy of the register set associated with the start of the block with the given label.
public void	setStarts(int `>= 0;` the block label label, RegisterSpecSet `non-null;` the register set to associate with the block specs) Sets the register set associated with the start of the block with the given label.

Inherited from org.droidparts.dexmaker.dx.util.MutabilityControl:: isImmutable isMutable setImmutable throwIfImmutable throwIfMutable

blockStarts	back to summary
private final RegisterSpecSet[] blockStarts `non-null;` array consisting of register sets representing the sets of variables already assigned upon entry to each block, where array indices correspond to block labels

emptySet	back to summary
private final RegisterSpecSet emptySet `non-null;` `RegisterSpecSet` to use when indicating a block that has no locals; it is empty and immutable but has an appropriate max size for the method

insnAssignments	back to summary
private final HashMap<Insn, RegisterSpec> insnAssignments `non-null;` map from instructions to the variable each assigns

regCount	back to summary
private final int regCount `>= 0;` the register count for the method

LocalVariableInfo	back to summary
public LocalVariableInfo(RopMethod method) Constructs an instance. Parameters method:RopMethod `non-null;` the method being represented by this instance

Method Detail

addAssignment back to summary

addAssignment	back to summary
public void addAssignment(Insn insn, RegisterSpec spec) Adds an assignment association for the given instruction and register spec. This throws an exception if the instruction doesn't actually perform a named variable assignment Note Although the instruction contains its own spec for the result, it still needs to be passed in explicitly to this method, since the spec that is stored here should always have a simple type and the one in the instruction can be an arbitrary `TypeBearer` (such as a constant value). Parameters insn:Insn `non-null;` the instruction in question spec:RegisterSpec `non-null;` the associated register spec

public void addAssignment(Insn insn, RegisterSpec spec)

Adds an assignment association for the given instruction and register spec. This throws an exception if the instruction doesn't actually perform a named variable assignment

Note

Although the instruction contains its own spec for the result, it still needs to be passed in explicitly to this method, since the spec that is stored here should always have a simple type and the one in the instruction can be an arbitrary TypeBearer (such as a constant value).

Parameters

insn:Insn: non-null; the instruction in question
spec:RegisterSpec: non-null; the associated register spec

debugDump	back to summary
public void debugDump()

getAssignment back to summary

getAssignment	back to summary
public RegisterSpec getAssignment(Insn insn) Gets the named register being assigned by the given instruction, if previously stored in this instance. Parameters insn:Insn `non-null;` instruction in question Returns:RegisterSpec `null-ok;` the named register being assigned, if any

public RegisterSpec getAssignment(Insn insn)

Gets the named register being assigned by the given instruction, if previously stored in this instance.

Parameters

insn:Insn: non-null; instruction in question

Returns:RegisterSpec

null-ok; the named register being assigned, if any

getAssignmentCount back to summary

getAssignmentCount	back to summary
public int getAssignmentCount() Gets the number of assignments recorded by this instance. Returns:int `>= 0;` the number of assignments

public int getAssignmentCount()

Gets the number of assignments recorded by this instance.

Returns:int: >= 0; the number of assignments

getStarts back to summary

getStarts	back to summary
public RegisterSpecSet getStarts(int label) Gets the register set associated with the start of the block with the given label. This returns an empty set with the appropriate max size if no set was associated with the block in question. Parameters label:int `>= 0;` the block label Returns:RegisterSpecSet `non-null;` the associated register set

public RegisterSpecSet getStarts(int label)

Gets the register set associated with the start of the block with the given label. This returns an empty set with the appropriate max size if no set was associated with the block in question.

Parameters

label:int: >= 0; the block label

Returns:RegisterSpecSet

non-null; the associated register set

getStarts back to summary

getStarts	back to summary
public RegisterSpecSet getStarts(BasicBlock block) Gets the register set associated with the start of the given block. This is just convenient shorthand for `getStarts(block.getLabel())`. Parameters block:BasicBlock `non-null;` the block in question Returns:RegisterSpecSet `non-null;` the associated register set

public RegisterSpecSet getStarts(BasicBlock block)

Gets the register set associated with the start of the given block. This is just convenient shorthand for getStarts(block.getLabel()).

Parameters

block:BasicBlock: non-null; the block in question

Returns:RegisterSpecSet

non-null; the associated register set

getStarts0 back to summary

getStarts0	back to summary
private RegisterSpecSet getStarts0(int label) Helper method, to get the starts for a label, throwing the right exception for range problems. Parameters label:int `>= 0;` the block label Returns:RegisterSpecSet `null-ok;` associated register set or `null` if there is none

private RegisterSpecSet getStarts0(int label)

Helper method, to get the starts for a label, throwing the right exception for range problems.

Parameters

label:int: >= 0; the block label

Returns:RegisterSpecSet

null-ok; associated register set or null if there is none

mergeStarts back to summary

mergeStarts	back to summary
public boolean mergeStarts(int label, RegisterSpecSet specs) Merges the given register set into the set for the block with the given label. If there was not already an associated set, then this is the same as calling `setStarts`. Otherwise, this will merge the two sets and call `setStarts` on the result of the merge. Parameters label:int `>= 0;` the block label specs:RegisterSpecSet `non-null;` the register set to merge into the start set for the block Returns:boolean `true` if the merge resulted in an actual change to the associated set (including storing one for the first time) or `false` if there was no change

public boolean mergeStarts(int label, RegisterSpecSet specs)

Merges the given register set into the set for the block with the given label. If there was not already an associated set, then this is the same as calling setStarts. Otherwise, this will merge the two sets and call setStarts on the result of the merge.

Parameters

label:int: >= 0; the block label
specs:RegisterSpecSet: non-null; the register set to merge into the start set for the block

Returns:boolean

true if the merge resulted in an actual change to the associated set (including storing one for the first time) or false if there was no change

mutableCopyOfStarts back to summary

mutableCopyOfStarts	back to summary
public RegisterSpecSet mutableCopyOfStarts(int label) Gets a mutable copy of the register set associated with the start of the block with the given label. This returns a newly-allocated empty `RegisterSpecSet` of appropriate max size if there is not yet any set associated with the block. Parameters label:int `>= 0;` the block label Returns:RegisterSpecSet `non-null;` the associated register set

public RegisterSpecSet mutableCopyOfStarts(int label)

Gets a mutable copy of the register set associated with the start of the block with the given label. This returns a newly-allocated empty RegisterSpecSet of appropriate max size if there is not yet any set associated with the block.

Parameters

label:int: >= 0; the block label

Returns:RegisterSpecSet

non-null; the associated register set

setStarts back to summary

setStarts	back to summary
public void setStarts(int label, RegisterSpecSet specs) Sets the register set associated with the start of the block with the given label. Parameters label:int `>= 0;` the block label specs:RegisterSpecSet `non-null;` the register set to associate with the block

public void setStarts(int label, RegisterSpecSet specs)

Sets the register set associated with the start of the block with the given label.

Parameters

label:int: >= 0; the block label
specs:RegisterSpecSet: non-null; the register set to associate with the block

public final Class LocalVariableInfo

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail