Package serp.bytecode

Class LineNumberTable

  • All Implemented Interfaces:
    BCEntity, InstructionPtr, VisitAcceptor

    public class LineNumberTable
    extends Attribute
    implements InstructionPtr
    Code blocks compiled from source have line number tables mapping opcodes to source lines. This table automatically maintains line numbers in ascending order by their start program counter position at all times.
    • Field Detail

      • _lineNumbers

        private java.util.List _lineNumbers
    • Constructor Detail

      • LineNumberTable

        LineNumberTable​(int nameIndex,
                        Attributes owner)
    • Method Detail

      • getLineNumbers

        public LineNumber[] getLineNumbers()
        Return the line numbers held in this table.
      • getLineNumber

        public LineNumber getLineNumber​(int pc)
        Return the line number for the given program counter, or null if none.
      • getLineNumber

        public LineNumber getLineNumber​(Instruction ins)
        Return the line number for the given instruction, or null if none.
      • setLineNumbers

        public void setLineNumbers​(LineNumber[] lines)
        Set the line numbers for the table. This method is useful when importing line numbers from another method.
      • addLineNumber

        public LineNumber addLineNumber​(LineNumber ln)
        Import a line number from another method.
        Returns:
        the newly added line number
      • addLineNumber

        public LineNumber addLineNumber()
        Add a new line number to this table.
      • addLineNumber

        public LineNumber addLineNumber​(int startPc,
                                        int line)
        Add a new line number to this table.
      • addLineNumber

        public LineNumber addLineNumber​(Instruction start,
                                        int line)
        Add a new line number to this table.
      • clear

        public void clear()
        Clear the line numbers.
      • removeLineNumber

        public boolean removeLineNumber​(LineNumber ln)
        Remove the given line.
        Returns:
        true if the line was removed, false otherwise
      • removeLineNumber

        public boolean removeLineNumber​(int pc)
        Remove the line number for the given program counter.
        Returns:
        true if the line was removed, false otherwise
      • removeLineNumber

        public boolean removeLineNumber​(Instruction ins)
        Remove the line number for the given instruction.
        Returns:
        true if the line was removed, false otherwise
      • updateTargets

        public void updateTargets()
        Description copied from interface: InstructionPtr
        Use the byte indexes read from the class file to calculate and set references to the target instruction(s) for this ptr. This method will be called after the byte code has been read in for the first time and before it is written after modification.
        Specified by:
        updateTargets in interface InstructionPtr
      • replaceTarget

        public void replaceTarget​(Instruction oldTarget,
                                  Instruction newTarget)
        Description copied from interface: InstructionPtr
        Replace the given old, likely invalid, target with a new target. The new target Instruction is guaranteed to be in the same code block as this InstructionPtr.
        Specified by:
        replaceTarget in interface InstructionPtr
      • acceptVisit

        public void acceptVisit​(BCVisitor visit)
        Description copied from interface: VisitAcceptor
        Accept a visit from a BCVisitor, calling the appropriate methods to notify the visitor that it has entered this entity, and to provide it with the proper callbacks for each sub-entity owned by this one.
        Specified by:
        acceptVisit in interface VisitAcceptor
      • getLength

        int getLength()
        Description copied from class: Attribute
        Return the length of the bytecode representation of this attribute in bytes, excluding the name index.
        Overrides:
        getLength in class Attribute
      • read

        void read​(Attribute other)
        Description copied from class: Attribute
        Copy the information from the given attribute to this one. Does nothing by default.
        Overrides:
        read in class Attribute
      • read

        void read​(java.io.DataInput in,
                  int length)
           throws java.io.IOException
        Description copied from class: Attribute
        Read the attribute bytecode from the given stream, up to length bytes, excluding the name index. Does nothing by default.
        Overrides:
        read in class Attribute
        Throws:
        java.io.IOException
      • write

        void write​(java.io.DataOutput out,
                   int length)
            throws java.io.IOException
        Description copied from class: Attribute
        Write the attribute bytecode to the given stream, up to length bytes, excluding the name index. Does nothing by default.
        Overrides:
        write in class Attribute
        Throws:
        java.io.IOException
      • getCode

        public Code getCode()
        Description copied from interface: InstructionPtr
        Returns the Code block that owns the Instruction(s) this InstructionPtr points to.
        Specified by:
        getCode in interface InstructionPtr