Class PositionList

java.lang.Object

com.android.dx.util.MutabilityControl

com.android.dx.util.FixedSizeList

com.android.dx.dex.code.PositionList

All Implemented Interfaces:

ToHuman

public final class PositionList
extends FixedSizeList

List of source position entries. This class includes a utility method to extract an instance out of a DalvInsnList.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PositionList.Entry	Entry in a position list.

Field Summary

Fields

Modifier and Type	Field	Description
static final PositionList	EMPTY	non-null; empty instance
static final int	IMPORTANT	constant for make(DalvInsnList, int) to indicate that only "important" position information should be returned.
static final int	LINES	constant for make(DalvInsnList, int) to indicate that only line number transitions should be returned
static final int	NONE	constant for make(DalvInsnList, int) to indicate that no actual position information should be returned

Constructor Summary

Constructors

Constructor	Description
PositionList(int size)	Constructs an instance.

Method Summary

Modifier and Type	Method	Description
PositionList.Entry	get(int n)	Gets the element at the given index.
static PositionList	make(DalvInsnList insns, int howMuch)	Extracts and returns the source position information out of an instruction list.
void	set(int n, PositionList.Entry entry)	Sets the entry at the given index.

Methods inherited from class FixedSizeList

equals, get0, getOrNull0, hashCode, set0, shrinkToFit, size, toHuman, toHuman, toString, toString

Methods inherited from class MutabilityControl

isImmutable, isMutable, setImmutable, throwIfImmutable, throwIfMutable

Methods inherited from class Object

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

Field Details

EMPTY

public static final PositionList EMPTY

non-null; empty instance

NONE

public static final int NONE

constant for make(DalvInsnList, int) to indicate that no actual position information should be returned

See Also:

• Constant Field Values

LINES

public static final int LINES

constant for make(DalvInsnList, int) to indicate that only line number transitions should be returned

See Also:

• Constant Field Values

IMPORTANT

public static final int IMPORTANT

constant for make(DalvInsnList, int) to indicate that only "important" position information should be returned. This includes block starts and instructions that might throw.

See Also:

• Constant Field Values

Constructor Details

PositionList

public PositionList(int size)

Constructs an instance. All indices initially contain null.

Parameters:

size - >= 0; the size of the list

Method Details

make

public static PositionList make(DalvInsnList insns,
 int howMuch)

Extracts and returns the source position information out of an instruction list.

Parameters:

insns - non-null; instructions to convert

howMuch - how much information should be included; one of the static constants defined by this class

Returns:

non-null; the positions list

get

public PositionList.Entry get(int n)

Gets the element at the given index. It is an error to call this with the index for an element which was never set; if you do that, this will throw NullPointerException.

Parameters:

n - >= 0, < size(); which index

Returns:

non-null; element at that index

set

public void set(int n,
 PositionList.Entry entry)

Sets the entry at the given index.

Parameters:

n - >= 0, < size(); which index

entry - non-null; the entry to set at n