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 | 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 | Description |
---|---|
InstructionFinder(InstructionList il) |
Modifier and Type | Method | Description |
---|---|---|
InstructionList |
getInstructionList() |
|
void |
reread() |
Reread the instruction list, e.g., after you've altered the list upon a
match.
|
java.util.Iterator |
search(java.lang.String pattern) |
Start search beginning from the start of the given instruction list.
|
java.util.Iterator |
search(java.lang.String pattern,
InstructionHandle from) |
Start search beginning from `from'.
|
java.util.Iterator |
search(java.lang.String pattern,
InstructionHandle from,
InstructionFinder.CodeConstraint constraint) |
Search for the given pattern in the instruction list.
|
java.util.Iterator |
search(java.lang.String pattern,
InstructionFinder.CodeConstraint constraint) |
Start search beginning from the start of the given instruction list.
|
public InstructionFinder(InstructionList il)
il
- instruction list to search for given patternspublic final void reread()
public final java.util.Iterator 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 search(java.lang.String pattern)
pattern
- the instruction pattern to search for, where case is ignoredpublic final java.util.Iterator 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 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()