Class IINC

java.lang.Object

org.apache.bcel.generic.Instruction

org.apache.bcel.generic.LocalVariableInstruction

org.apache.bcel.generic.IINC

All Implemented Interfaces:

Cloneable, IndexedInstruction, TypedInstruction

public class IINC
extends LocalVariableInstruction

IINC - Increment local variable by constant

Field Summary

Fields inherited from class LocalVariableInstruction

n

Modifier and Type	Field	Description
protected int	n	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Fields inherited from class Instruction

length, opcode

Modifier and Type	Field	Description
protected short	length	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected short	opcode	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Constructor Summary

Constructors

Constructor	Description
IINC(int n, int c)	Constructs an IINC instruction.

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor v)	Calls corresponding visitor method(s).
void	dump(DataOutputStream out)	Dumps instruction as byte code to stream out.
final int	getIncrement()	Gets the increment factor.
Type	getType(ConstantPoolGen cp)	Gets the int type.
protected void	initFromFile(ByteSequence bytes, boolean wide)	Reads needed data (for example index) from file.
final void	setIncrement(int c)	Sets increment factor.
final void	setIndex(int index)	Sets the index of the local variable.
String	toString(boolean verbose)	Returns mnemonic for instruction.

Methods inherited from class LocalVariableInstruction

getCanonicalTag, getIndex

Modifier and Type	Method	Description
short	getCanonicalTag()	Gets the canonical tag for instruction, for example, ALOAD for ALOAD_0.
final int	getIndex()	Gets the local variable index (n) referred to by this instruction.

Methods inherited from class Instruction

consumeStack, copy, equals, getComparator, getLength, getName, getOpcode, hashCode, isValidByte, isValidShort, produceStack, readInstruction, setComparator, toString, toString

Modifier and Type	Method	Description
int	consumeStack(ConstantPoolGen cpg)	This method also gives right results for instructions whose effect on the stack depends on the constant pool entry they reference.
Instruction	copy()	Use with caution, since 'BranchInstruction's have a 'target' reference which is not copied correctly (only basic types are).
boolean	equals(Object that)	Tests for equality, delegated to comparator
static InstructionComparator	getComparator()	Deprecated. (6.0) use the built in comparator, or wrap this class in another object that implements these methods
int	getLength()	Gets the length (in bytes) of instruction.
String	getName()	Gets the name of instruction, that is, opcode name.
short	getOpcode()	Gets this instruction's opcode.
int	hashCode()	Gets the hashCode of this object.
static boolean	isValidByte(int value)	Tests if the value can fit in a byte (signed).
static boolean	isValidShort(int value)	Tests if the value can fit in a short (signed).
int	produceStack(ConstantPoolGen cpg)	This method also gives right results for instructions whose effect on the stack depends on the constant pool entry they reference.
static Instruction	readInstruction(ByteSequence bytes)	Reads an instruction from (byte code) input stream and return the appropriate object.
static void	setComparator(InstructionComparator c)	Deprecated. (6.0) use the built in comparator, or wrap this class in another object that implements these methods
String	toString()
String	toString(ConstantPool cp)	Gets the mnemonic for instruction with symbolic references resolved.

Methods inherited from class Object

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

Constructor Details

IINC

public IINC(int n,
 int c)

Constructs an IINC instruction.

Parameters:

n - index of local variable.

c - increment factor.

Method Details

accept

public void accept(Visitor v)

Calls corresponding visitor method(s). The order is: Call visitor methods of implemented interfaces first, then call methods according to the class hierarchy in descending order, that is, the most specific visitXXX() call comes last.

Specified by:

accept in class Instruction

Parameters:

v - Visitor object.

dump

public void dump(DataOutputStream out)
          throws IOException

Dumps instruction as byte code to stream out.

Overrides:

dump in class LocalVariableInstruction

Parameters:

out - Output stream.

Throws:

IOException - Thrown when an I/O exception of some sort has occurred.

getIncrement

public final int getIncrement()

Gets the increment factor.

Returns:

increment factor.

getType

public Type getType(ConstantPoolGen cp)

Gets the int type.

Specified by:

getType in interface TypedInstruction

Overrides:

getType in class LocalVariableInstruction

Parameters:

cp - The constant pool generator.

Returns:

int type.

initFromFile

protected void initFromFile(ByteSequence bytes,
 boolean wide)
                     throws IOException

Reads needed data (for example index) from file.

Overrides:

initFromFile in class LocalVariableInstruction

Parameters:

bytes - byte sequence to read from.

wide - "wide" instruction flag.

Throws:

IOException - Thrown if the implementation needs to read data from the file

setIncrement

public final void setIncrement(int c)

Sets increment factor.

Parameters:

c - The increment factor.

Throws:

ClassGenException - Thrown if the increment is out of bounds.

setIndex

public final void setIndex(int index)

Sets the index of the local variable.

Specified by:

setIndex in interface IndexedInstruction

Overrides:

setIndex in class LocalVariableInstruction

Parameters:

index - index of local variable.

Throws:

ClassGenException - Thrown if index is out of bounds.

See Also:

• LocalVariableInstruction.setIndexOnly(int)

toString

public String toString(boolean verbose)

Returns mnemonic for instruction.

Overrides:

toString in class LocalVariableInstruction

Parameters:

verbose - long/short format switch.

Returns:

mnemonic for instruction.