Class LineNumberTableReader

java.lang.Object

com.ibm.wala.shrike.shrikeCT.AttributeReader

com.ibm.wala.shrike.shrikeCT.LineNumberTableReader

public final class LineNumberTableReader
extends AttributeReader

This class reads LineNumberTable attributes.

Instead of constructing a LineNumberTableReader directly, consider just calling LineNumberTableReader.makeBytecodeToSourceMap for convenient access to aggregate line number data from all the LineNumberTable attributes for a given Code.

Field Summary

Fields inherited from class AttributeReader

attr, cr, length

Modifier and Type	Field	Description
protected final int	attr
protected final ClassReader	cr
protected final int	length

Constructor Summary

Constructors

Constructor	Description
LineNumberTableReader(ClassReader.AttrIterator iter)	Build a reader for a LineNumberTable attribute.

Method Summary

Modifier and Type	Method	Description
int[]	getRawTable()
static int[]	makeBytecodeToSourceMap(CodeReader code)	Construct a "bytecode to source" map for the given code.

Methods inherited from class AttributeReader

checkSize, checkSizeEquals, getClassReader, getRawOffset, getRawSize

Modifier and Type	Method	Description
protected final void	checkSize(int offset, int len)	Ensure that the len bytes starting at offset fall within the attribute data.
protected final void	checkSizeEquals(int offset, int len)	Ensure that the len bytes starting at offset end at the end of the attribute data.
final ClassReader	getClassReader()
final int	getRawOffset()
final int	getRawSize()

Methods inherited from class Object

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

Constructor Details

LineNumberTableReader

public LineNumberTableReader(ClassReader.AttrIterator iter)
                      throws InvalidClassFileException

Build a reader for a LineNumberTable attribute.

Throws:

InvalidClassFileException

Method Details

getRawTable

public int[] getRawTable()

Returns:

the raw line number table data, a flattened sequence of (startPC, lineNumber) pairs

makeBytecodeToSourceMap

public static int[] makeBytecodeToSourceMap(CodeReader code)
                                     throws InvalidClassFileException,
IllegalArgumentException

Construct a "bytecode to source" map for the given code. This method aggregates all the LineNumberTable attributes for the code into one handy data structure.

Returns:

an array mapping each byte of the bytecode bytes to the line number that that byte belongs to, or null if there is no line number data in the Code

Throws:

InvalidClassFileException

IllegalArgumentException