Package serp.bytecode

Class LocalTable

    • Field Detail

      • _locals

        private java.util.List _locals
    • Constructor Detail

      • LocalTable

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

      • getLocals

        public Local[] getLocals()
        Return all the locals of this method.
      • getLocal

        public Local getLocal​(int local)
        Return the local with the given locals index, or null if none.
      • getLocal

        public Local getLocal​(java.lang.String name)
        Return the local with the given name, or null if none. If multiple locals have the given name, which is returned is undefined.
      • getLocals

        public Local[] getLocals​(java.lang.String name)
        Return all locals with the given name, or empty array if none.
      • setLocals

        public void setLocals​(Local[] locals)
        Set the locals of this table. This method is useful when importing locals from another method.
      • addLocal

        public Local addLocal​(Local local)
        Import a local from another method/class. Note that the program counter and length from the given local is copied directly, and thus will be incorrect unless this method is the same as the one the local is copied from, or the pc and length are reset.
      • addLocal

        public Local addLocal()
        Add a local to this table.
      • newLocal

        protected abstract Local newLocal()
        Create a new element of this table.
      • newLocalArray

        protected abstract Local[] newLocalArray​(int size)
        Create a new array.
      • addLocal

        public Local addLocal​(java.lang.String name,
                              java.lang.String type)
        Add a local to this table.
      • clear

        public void clear()
        Clear all locals from this table.
      • removeLocal

        public boolean removeLocal​(int local)
        Removes the local with the given locals index from the table.
        Returns:
        true if a local was removed, false otherwise
      • removeLocal

        public boolean removeLocal​(java.lang.String name)
        Removes the local with the given name from this method.
        Returns:
        true if a local was removed, false otherwise
      • removeLocal

        public boolean removeLocal​(Local local)
        Removes a local from this method. After this method, the local will be invalid, and the result of any operations on it is undefined.
        Returns:
        true if a local 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
      • 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
      • 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