Package com.tonic.analysis.instruction

Class LdcInstruction

java.lang.Object

com.tonic.analysis.instruction.Instruction

com.tonic.analysis.instruction.LdcInstruction

public class LdcInstruction
extends Instruction

Represents the LDC instruction (0x12).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LdcInstruction.ConstantType	The kinds of constant-pool entry an ldc-family instruction can load.

Constructor Summary

Constructors

Constructor	Description
LdcInstruction(ConstPool constPool, int opcode, int offset, int cpIndex)	Constructs an LdcInstruction.

Method Summary

Modifier and Type	Method	Description
void	accept(AbstractBytecodeVisitor visitor)	Accepts a visitor for bytecode analysis.
LdcInstruction.ConstantType	getConstantType()	Classifies the referenced constant-pool entry.
ConstPool	getConstPool()
int	getCpIndex()
int	getLocalChange()	Returns the change in local variables caused by this instruction.
int	getStackChange()	Returns the change in stack size caused by this instruction.
String	resolveConstant()	Resolves and returns a string representation of the constant.
String	toString()	Returns a string representation of the instruction.
void	write(DataOutputStream dos)	Writes the LDC opcode and its operand to the DataOutputStream.

Methods inherited from class com.tonic.analysis.instruction.Instruction

getLength, getOffset, getOpcode, setOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LdcInstruction

public LdcInstruction(ConstPool constPool,
                      int opcode,
                      int offset,
                      int cpIndex)

Constructs an LdcInstruction.

Parameters:

constPool - The constant pool associated with the class.

opcode - The nominal opcode (ignored; the form is derived from cpIndex).

offset - The bytecode offset of the instruction.

cpIndex - The constant pool index.

Method Detail

getCpIndex

public int getCpIndex()

Returns:

the cp index

getConstPool

public ConstPool getConstPool()

Returns:

the const pool

accept

public void accept(AbstractBytecodeVisitor visitor)

Description copied from class: Instruction

Accepts a visitor for bytecode analysis.

Specified by:

accept in class Instruction

Parameters:

visitor - The visitor to accept.

write

public void write(DataOutputStream dos)
           throws IOException

Writes the LDC opcode and its operand to the DataOutputStream.

Specified by:

write in class Instruction

Parameters:

dos - The DataOutputStream to write to.

Throws:

IOException - If an I/O error occurs.

getStackChange

public int getStackChange()

Returns the change in stack size caused by this instruction.

Specified by:

getStackChange in class Instruction

Returns:

The stack size change (pushes a reference or primitive).

getConstantType

public LdcInstruction.ConstantType getConstantType()

Classifies the referenced constant-pool entry.

Returns:

the constant kind, or UNKNOWN for an invalid index or unrecognized entry

getLocalChange

public int getLocalChange()

Returns the change in local variables caused by this instruction.

Specified by:

getLocalChange in class Instruction

Returns:

The local variables size change (none).

resolveConstant

public String resolveConstant()

Resolves and returns a string representation of the constant.

Returns:

The constant as a string.

toString

public String toString()

Returns a string representation of the instruction.

Overrides:

toString in class Instruction

Returns:

The mnemonic, constant pool index, and resolved constant.