Class LOOKUPSWITCH

java.lang.Object

org.apache.bcel.generic.Instruction

org.apache.bcel.generic.BranchInstruction

org.apache.bcel.generic.Select

org.apache.bcel.generic.LOOKUPSWITCH

All Implemented Interfaces:

Cloneable, InstructionTargeter, StackConsumer, StackProducer, VariableLengthInstruction

public class LOOKUPSWITCH
extends Select

LOOKUPSWITCH - Switch with unordered set of values

See Also:

• SWITCH

Field Summary

Fields inherited from class Select

fixed_length, indices, match, match_length, padding, targets

Modifier and Type	Field	Description
protected int	fixed_length	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected int[]	indices	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected int[]	match	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected int	match_length	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected int	padding	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected InstructionHandle[]	targets	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Fields inherited from class BranchInstruction

index, position, target

Modifier and Type	Field	Description
protected int	index	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected int	position	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected InstructionHandle	target	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
LOOKUPSWITCH(int[] match, InstructionHandle[] targets, InstructionHandle defaultTarget)	Constructs a LOOKUPSWITCH instruction.

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor v)	Call corresponding visitor method(s).
void	dump(DataOutputStream out)	Dumps instruction as byte code to stream out.
protected void	initFromFile(ByteSequence bytes, boolean wide)	Reads needed data (for example index) from file.

Methods inherited from class Select

clone, containsTarget, getIndices, getMatchs, getTargets, setTarget, toString, updatePosition, updateTarget

Modifier and Type	Method	Description
protected Object	clone()
boolean	containsTarget(InstructionHandle ih)	Tests whether this targeter targets the specified instruction handle.
int[]	getIndices()	Gets the match target offsets.
int[]	getMatchs()	Gets the match indices.
InstructionHandle[]	getTargets()	Gets the match targets.
void	setTarget(int i, InstructionHandle target)	Sets branch target for 'i'th case.
String	toString(boolean verbose)	Long output format: <position in byte code> <name of opcode> "["<opcode number>"]" "("<length of instruction>")" "<"<target instruction>">" "@"<branch target offset>
protected int	updatePosition(int offset, int maxOffset)	Since this is a variable length instruction, it may shift the following instructions which then need to update their position.
void	updateTarget(InstructionHandle oldIh, InstructionHandle newIh)	Replaces the target of this targeter from this old handle to the new handle.

Methods inherited from class BranchInstruction

getIndex, getPosition, getTarget, getTargetOffset, getTargetOffset, setIndex, setPosition, setTarget

Modifier and Type	Method	Description
final int	getIndex()	Gets the target offset in byte code.
protected int	getPosition()	Gets the position.
InstructionHandle	getTarget()	Gets the target of branch instruction.
protected int	getTargetOffset()	Gets the offset to this instruction's target.
protected int	getTargetOffset(InstructionHandle target)	Gets the offset to target relative to this instruction.
protected void	setIndex(int index)	Sets the index.
protected void	setPosition(int position)	Sets the position.
void	setTarget(InstructionHandle target)	Sets branch target.

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

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

Methods inherited from interface StackConsumer

consumeStack

Modifier and Type	Method	Description
int	consumeStack(ConstantPoolGen cpg)	Gets how many words are consumed from stack.

Methods inherited from interface StackProducer

produceStack

Modifier and Type	Method	Description
int	produceStack(ConstantPoolGen cpg)	Gets how many words are produced on stack.

Constructor Details

LOOKUPSWITCH

public LOOKUPSWITCH(int[] match,
 InstructionHandle[] targets,
 InstructionHandle defaultTarget)

Constructs a LOOKUPSWITCH instruction.

Parameters:

match - array of match values.

targets - array of branch targets.

defaultTarget - default branch target.

Method Details

accept

public void accept(Visitor v)

Call 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 Select

Parameters:

out - Output stream.

Throws:

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

initFromFile

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

Reads needed data (for example index) from file.

Overrides:

initFromFile in class Select

Parameters:

bytes - input stream.

wide - wide prefix?

Throws:

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

See Also:

• InstructionList