instructionlist.html

一个用于对.class文件进行插桩的开源工具

<DL>
<DD>Find the target instruction (handle) that corresponds to the given target
 position (byte code offset).<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ihs</CODE> - array of instruction handles, i.e. il.getInstructionHandles()<DD><CODE>pos</CODE> - array of positions corresponding to ihs, i.e. il.getInstructionPositions()<DD><CODE>count</CODE> - length of arrays<DD><CODE>target</CODE> - target position to search for<DT><B>Returns:</B><DD>target position's instruction handle if available</DL>
</DD>
</DL>
<HR>

<A NAME="findHandle(int)"><!-- --></A><H3>
findHandle</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>findHandle</B>(int&nbsp;pos)</PRE>
<DL>
<DD>Get instruction handle for instruction at byte code position pos.
 This only works properly, if the list is freshly initialized from a byte array or
 setPositions() has been called before this method.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - byte code position to search for<DT><B>Returns:</B><DD>target position's instruction handle if available</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.InstructionHandle, org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A>&nbsp;ih,
                                <A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Append another list after instruction (handle) ih contained in this list.
 Consumes argument list, i.e., it becomes empty.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ih</CODE> - where to append the instruction list<DD><CODE>il</CODE> - Instruction list to append to this one<DT><B>Returns:</B><DD>instruction handle pointing to the <B>first</B> appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.Instruction, org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i,
                                <A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Append another list after instruction i contained in this list.
 Consumes argument list, i.e., it becomes empty.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - where to append the instruction list<DD><CODE>il</CODE> - Instruction list to append to this one<DT><B>Returns:</B><DD>instruction handle pointing to the <B>first</B> appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Append another list to this one.
 Consumes argument list, i.e., it becomes empty.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>il</CODE> - list to append to end of this list<DT><B>Returns:</B><DD>instruction handle of the <B>first</B> appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>
<DD>Append an instruction to the end of this list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - instruction to append<DT><B>Returns:</B><DD>instruction handle of the appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.BranchInstruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/BranchHandle.html">BranchHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/BranchInstruction.html">BranchInstruction</A>&nbsp;i)</PRE>
<DL>
<DD>Append a branch instruction to the end of this list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - branch instruction to append<DT><B>Returns:</B><DD>branch instruction handle of the appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.Instruction, org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i,
                                <A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;j)</PRE>
<DL>
<DD>Append a single instruction j after another instruction i, which
 must be in this list of course!<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - Instruction in list<DD><CODE>j</CODE> - Instruction to append after i in list<DT><B>Returns:</B><DD>instruction handle of the first appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.Instruction, org.apache.bcel.generic.CompoundInstruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i,
                                <A HREF="../../../../org/apache/bcel/generic/CompoundInstruction.html">CompoundInstruction</A>&nbsp;c)</PRE>
<DL>
<DD>Append a compound instruction, after instruction i.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - Instruction in list<DD><CODE>c</CODE> - The composite instruction (containing an InstructionList)<DT><B>Returns:</B><DD>instruction handle of the first appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.CompoundInstruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/CompoundInstruction.html">CompoundInstruction</A>&nbsp;c)</PRE>
<DL>
<DD>Append a compound instruction.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>c</CODE> - The composite instruction (containing an InstructionList)<DT><B>Returns:</B><DD>instruction handle of the first appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.InstructionHandle, org.apache.bcel.generic.CompoundInstruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A>&nbsp;ih,
                                <A HREF="../../../../org/apache/bcel/generic/CompoundInstruction.html">CompoundInstruction</A>&nbsp;c)</PRE>
<DL>
<DD>Append a compound instruction.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ih</CODE> - where to append the instruction list<DD><CODE>c</CODE> - The composite instruction (containing an InstructionList)<DT><B>Returns:</B><DD>instruction handle of the first appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.InstructionHandle, org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A>&nbsp;ih,
                                <A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>
<DD>Append an instruction after instruction (handle) ih contained in this list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ih</CODE> - where to append the instruction list<DD><CODE>i</CODE> - Instruction to append<DT><B>Returns:</B><DD>instruction handle pointing to the <B>first</B> appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="append(org.apache.bcel.generic.InstructionHandle, org.apache.bcel.generic.BranchInstruction)"><!-- --></A><H3>
append</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/BranchHandle.html">BranchHandle</A> <B>append</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A>&nbsp;ih,
                           <A HREF="../../../../org/apache/bcel/generic/BranchInstruction.html">BranchInstruction</A>&nbsp;i)</PRE>
<DL>
<DD>Append an instruction after instruction (handle) ih contained in this list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ih</CODE> - where to append the instruction list<DD><CODE>i</CODE> - Instruction to append<DT><B>Returns:</B><DD>instruction handle pointing to the <B>first</B> appended instruction</DL>
</DD>
</DL>
<HR>

<A NAME="insert(org.apache.bcel.generic.InstructionHandle, org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
insert</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>insert</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A>&nbsp;ih,
                                <A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Insert another list before Instruction handle ih contained in this list.
 Consumes argument list, i.e., it becomes empty.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - where to append the instruction list<DD><CODE>il</CODE> - Instruction list to insert<DT><B>Returns:</B><DD>instruction handle of the first inserted instruction</DL>
</DD>
</DL>
<HR>

<A NAME="insert(org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
insert</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>insert</B>(<A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Insert another list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>il</CODE> - list to insert before start of this list<DT><B>Returns:</B><DD>instruction handle of the first inserted instruction</DL>
</DD>
</DL>
<HR>

<A NAME="insert(org.apache.bcel.generic.Instruction, org.apache.bcel.generic.InstructionList)"><!-- --></A><H3>
insert</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>insert</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i,
                                <A HREF="../../../../org/apache/bcel/generic/InstructionList.html">InstructionList</A>&nbsp;il)</PRE>
<DL>
<DD>Insert another list before Instruction i contained in this list.
 Consumes argument list, i.e., it becomes empty.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>i</CODE> - where to append the instruction list<DD><CODE>il</CODE> - Instruction list to insert<DT><B>Returns:</B><DD>instruction handle pointing to the first inserted instruction,
 i.e., il.getStart()</DL>
</DD>
</DL>
<HR>

<A NAME="insert(org.apache.bcel.generic.Instruction)"><!-- --></A><H3>
insert</H3>
<PRE>
public <A HREF="../../../../org/apache/bcel/generic/InstructionHandle.html">InstructionHandle</A> <B>insert</B>(<A HREF="../../../../org/apache/bcel/generic/Instruction.html">Instruction</A>&nbsp;i)</PRE>
<DL>