public class InstructionFinder
extends java.lang.Object
This class internally uses the java.util.regex package to search for regular expressions. A typical application would look like this:
InstructionFinder f = new InstructionFinder(il); String pat = "IfInstruction ICONST_0 GOTO ICONST_1 NOP (IFEQ|IFNE)"; for(Iterator i = f.search(pat, constraint); i.hasNext(); ) { InstructionHandle[] match = (InstructionHandle[])i.next(); ... il.delete(match[1], match[5]); ... }
Instruction
,
InstructionList
Modifier and Type | Class and Description |
---|---|
static interface |
InstructionFinder.CodeConstraint
Code patterns found may be checked using an additional user-defined
constraint object whether they really match the needed criterion.
|
Constructor and Description |
---|
InstructionFinder(InstructionList il) |
Modifier and Type | Method and Description |
---|---|
InstructionList |
getInstructionList() |
void |
reread()
Reread the instruction list, e.g., after you've altered the list upon a
match.
|
java.util.Iterator<InstructionHandle[]> |
search(java.lang.String pattern)
Start search beginning from the start of the given instruction list.
|
java.util.Iterator<InstructionHandle[]> |
search(java.lang.String pattern,
InstructionFinder.CodeConstraint constraint)
Start search beginning from the start of the given instruction list.
|
java.util.Iterator<InstructionHandle[]> |
search(java.lang.String pattern,
InstructionHandle from)
Start search beginning from `from'.
|
java.util.Iterator<InstructionHandle[]> |
search(java.lang.String pattern,
InstructionHandle from,
InstructionFinder.CodeConstraint constraint)
Search for the given pattern in the instruction list.
|
public InstructionFinder(InstructionList il)
il
- instruction list to search for given patternspublic final void reread()
public final java.util.Iterator<InstructionHandle[]> search(java.lang.String pattern, InstructionHandle from, InstructionFinder.CodeConstraint constraint)
Example pattern:
search("BranchInstruction NOP ((IfInstruction|GOTO)+ ISTORE Instruction)*");
If you alter the instruction list upon a match such that other matching areas are affected, you should call reread() to update the finder and call search() again, because the matches are cached.
pattern
- the instruction pattern to search for, where case is ignoredfrom
- where to start the search in the instruction listconstraint
- optional CodeConstraint to check the found code pattern for
user-defined constraintspublic final java.util.Iterator<InstructionHandle[]> search(java.lang.String pattern)
pattern
- the instruction pattern to search for, where case is ignoredpublic final java.util.Iterator<InstructionHandle[]> search(java.lang.String pattern, InstructionHandle from)
pattern
- the instruction pattern to search for, where case is ignoredfrom
- where to start the search in the instruction listpublic final java.util.Iterator<InstructionHandle[]> search(java.lang.String pattern, InstructionFinder.CodeConstraint constraint)
pattern
- the instruction pattern to search for, case is ignoredconstraint
- constraints to be checked on matching codepublic final InstructionList getInstructionList()