com.android.dx.dex.code.form

Class Form31t

java.lang.Object

com.android.dx.dex.code.InsnFormat

com.android.dx.dex.code.form.Form31t

public final class Form31t
extends InsnFormat

Instruction format 31t. See the instruction format spec for details.

Field Summary

Fields

Modifier and Type	Field and Description
static InsnFormat	THE_ONE non-null; unique instance of this class

Fields inherited from class com.android.dx.dex.code.InsnFormat

ALLOW_EXTENDED_OPCODES

Method Summary

Modifier and Type	Method and Description
boolean	branchFits(TargetInsn insn) Returns whether or not the given instruction's branch offset will fit in this instance's format.
int	codeSize() Gets the code size of instructions that use this format.
java.util.BitSet	compatibleRegs(DalvInsn insn) Returns which of a given instruction's registers will fit in this instance's format.
java.lang.String	insnArgString(DalvInsn insn) Returns the string form of the arguments to the given instruction.
java.lang.String	insnCommentString(DalvInsn insn, boolean noteIndices) Returns the associated comment for the given instruction, if any.
boolean	isCompatible(DalvInsn insn) Returns whether or not the given instruction's arguments will fit in this instance's format.
void	writeTo(AnnotatedOutput out, DalvInsn insn) Writes the code units for the given instruction to the given output destination.

Methods inherited from class com.android.dx.dex.code.InsnFormat

argIndex, branchComment, branchString, codeUnit, codeUnit, cstComment, cstString, isRegListSequential, listingString, literalBitsComment, literalBitsString, makeByte, opcodeUnit, opcodeUnit, regListString, regRangeString, signedFitsInByte, signedFitsInNibble, signedFitsInShort, unsignedFitsInByte, unsignedFitsInNibble, unsignedFitsInShort, write, write, write, write, write, write, write, write, write

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

THE_ONE

public static final InsnFormat THE_ONE

non-null; unique instance of this class

Method Detail

insnArgString

public java.lang.String insnArgString(DalvInsn insn)

Returns the string form of the arguments to the given instruction. The instruction must be of this instance's format. If the instruction has no arguments, then the result should be "", not null.

Subclasses must override this method.

Specified by:

insnArgString in class InsnFormat

Parameters:

insn - non-null; the instruction

Returns:

non-null; the string form

insnCommentString

public java.lang.String insnCommentString(DalvInsn insn,
                                          boolean noteIndices)

Returns the associated comment for the given instruction, if any. The instruction must be of this instance's format. If the instruction has no comment, then the result should be "", not null.

Subclasses must override this method.

Specified by:

insnCommentString in class InsnFormat

Parameters:

insn - non-null; the instruction

noteIndices - whether to include an explicit notation of constant pool indices

Returns:

non-null; the string form

codeSize

public int codeSize()

Gets the code size of instructions that use this format. The size is a number of 16-bit code units, not bytes. This should throw an exception if this format is of variable size.

Specified by:

codeSize in class InsnFormat

Returns:

>= 0; the instruction length in 16-bit code units

isCompatible

public boolean isCompatible(DalvInsn insn)

Returns whether or not the given instruction's arguments will fit in this instance's format. This includes such things as counting register arguments, checking register ranges, and making sure that additional arguments are of appropriate types and are in-range. If this format has a branch target but the instruction's branch offset is unknown, this method will simply not check the offset.

Subclasses must override this method.

Specified by:

isCompatible in class InsnFormat

Parameters:

insn - non-null; the instruction to check

Returns:

true iff the instruction's arguments are appropriate for this instance, or false if not

compatibleRegs

public java.util.BitSet compatibleRegs(DalvInsn insn)

Returns which of a given instruction's registers will fit in this instance's format.

The default implementation of this method always returns an empty BitSet. Subclasses must override this method if they have registers.

Overrides:

compatibleRegs in class InsnFormat

Parameters:

insn - non-null; the instruction to check

Returns:

non-null; a BitSet flagging registers in the register list that are compatible to this format

branchFits

public boolean branchFits(TargetInsn insn)

Returns whether or not the given instruction's branch offset will fit in this instance's format. This always returns false for formats that don't include a branch offset.

The default implementation of this method always returns false. Subclasses must override this method if they include branch offsets.

Overrides:

branchFits in class InsnFormat

Parameters:

insn - non-null; the instruction to check

Returns:

true iff the instruction's branch offset is appropriate for this instance, or false if not

writeTo

public void writeTo(AnnotatedOutput out,
                    DalvInsn insn)

Writes the code units for the given instruction to the given output destination. The instruction must be of this instance's format.

Subclasses must override this method.

Specified by:

writeTo in class InsnFormat

Parameters:

out - non-null; the output destination to write to

insn - non-null; the instruction to write