Package com.pnfsoftware.jeb.core.units.code.asm.processor

Class AbstractInstructionOperandGeneric

java.lang.Object

com.pnfsoftware.jeb.core.units.code.asm.processor.AbstractInstructionOperandGeneric

All Implemented Interfaces:

IInstructionOperandGeneric, IInstructionOperandRegisterBased, IInstructionOperandSized, IInstructionOperand

Direct Known Subclasses:

AbstractInstructionOperandList, Operand

@Ser
public abstract class AbstractInstructionOperandGeneric
extends Object
implements IInstructionOperandGeneric

Reference implementation for IInstructionOperandGeneric.

Field Summary

Fields

Modifier and Type	Field	Description
protected int	bitsize
protected int	type
protected long	value

Fields inherited from interface com.pnfsoftware.jeb.core.units.code.asm.processor.IInstructionOperandGeneric

TYPE_ADDR, TYPE_ALIAS, TYPE_CMA, TYPE_IMM, TYPE_LIST, TYPE_MEMIMM, TYPE_MEMREG, TYPE_REG, TYPE_RELADDR, TYPE_SIMM, TYPE_USER_1

Constructor Summary

Constructors

Constructor	Description
AbstractInstructionOperandGeneric(int type, int bitsize, long value)	Create a generic instruction operand.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
String	format(IInstruction insn, long address)	Format the operand, assuming it is used by an instruction at the provided address.
protected CharSequence	formatOperand(IInstruction insn, long address)
String	getAlias(long v)	Get the optional alias string to be displayed instead of a given integer value.
int	getOperandBitsize()	Get the operand size in bits.
int	getOperandType()	Get the operand type.
long	getOperandValue()	Get the value of the operand.
long	getOperandValue(long address)	Get the value of the operand, adjusted (if relevant) for an instruction located at the provided address.
String	getPrefix(IInstruction insn)	Get the optional prefix to be prepended to the formatted operand.
String	getSuffix(IInstruction insn)	Get the optional suffix to be appended to the formatted operand.
int	hashCode()
protected final String	innerFormat()	Returns an inner representation of this object, where address is unknown
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.asm.processor.IInstructionOperandGeneric

isImmediate, isRegister

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.asm.processor.IInstructionOperandRegisterBased

getRegisterName

Field Details

type

protected int type

bitsize

protected int bitsize

value

protected long value

Constructor Details

AbstractInstructionOperandGeneric

public AbstractInstructionOperandGeneric(int type,
 int bitsize,
 long value)

Create a generic instruction operand.

Parameters:

type - operand type

bitsize - operand size in bits

value - operand value

Method Details

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getOperandType

public int getOperandType()

Description copied from interface: IInstructionOperandGeneric

Get the operand type. Used to determine how to interpret the results provided by IInstructionOperandSized.getOperandBitsize() and IInstructionOperandGeneric.getOperandValue().

Specified by:

getOperandType in interface IInstructionOperandGeneric

Returns:

one of the TYPE_Xxx constants

getOperandBitsize

public int getOperandBitsize()

Description copied from interface: IInstructionOperandSized

Get the operand size in bits.

Specified by:

getOperandBitsize in interface IInstructionOperandSized

Returns:

operand size in bits

getOperandValue

public long getOperandValue()

Description copied from interface: IInstructionOperandGeneric

Get the value of the operand. The interpretation of the value depends on the operand type and the underlying implementation.

Specified by:

getOperandValue in interface IInstructionOperandGeneric

Returns:

the opaque operand value

getOperandValue

public long getOperandValue(long address)

Description copied from interface: IInstructionOperandGeneric

Get the value of the operand, adjusted (if relevant) for an instruction located at the provided address. Example: If the operand is a memory access, this method may return "address + operand value".

Specified by:

getOperandValue in interface IInstructionOperandGeneric

Parameters:

address - instruction address

Returns:

the address-adjusted operand value

format

public String format(IInstruction insn,
 long address)

Description copied from interface: IInstructionOperand

Format the operand, assuming it is used by an instruction at the provided address.

Specified by:

format in interface IInstructionOperand

Parameters:

insn - optional instruction using this operand. Note that this operand may not be directly returned by insn.getOperands(), e.g., in the case of instructions with nested operands

address - optional instruction address, 0 if none. The instruction address is sometimes necessary to properly render PC-dependent operands

Returns:

simple string representation of the operand

formatOperand

protected CharSequence formatOperand(IInstruction insn,
 long address)

getPrefix

public String getPrefix(IInstruction insn)

Description copied from interface: IInstructionOperandGeneric

Get the optional prefix to be prepended to the formatted operand.

Specified by:

getPrefix in interface IInstructionOperandGeneric

Parameters:

insn - instruction containing this operand

Returns:

optional prefix

getSuffix

public String getSuffix(IInstruction insn)

Description copied from interface: IInstructionOperandGeneric

Get the optional suffix to be appended to the formatted operand.

Specified by:

getSuffix in interface IInstructionOperandGeneric

Parameters:

insn - instruction containing this operand

Returns:

optional suffix

getAlias

public String getAlias(long v)

Description copied from interface: IInstructionOperandGeneric

Get the optional alias string to be displayed instead of a given integer value.

Specified by:

getAlias in interface IInstructionOperandGeneric

Parameters:

v - integer value to alias

Returns:

optional alias

toString

public String toString()

Overrides:

toString in class Object

innerFormat

protected final String innerFormat()

Returns an inner representation of this object, where address is unknown

Returns:

inner representation