Interface DataBuffer


public interface DataBuffer
DataBuffer provides an array like interface into a set of Data at a specific index. Data can be retrieved by using a positive offset from the current position. The purpose of this class is to provide an opaque storage mechanism for Data that is made up of other Data items. This interface does not provide methods to reposition the data item buffer. This is so that it is clear that methods accepeting this base class are not to mess which the base Address for this object.
  • Method Summary

    Modifier and Type
    Method
    Description
    Get the Address which corresponds to the offset 0.
    getData(int offset)
    Get one Data item from the buffer at the current position plus offset.
    getData(int start, int end)
    Get an array of data items that begin at or after start up to end.
    getDataAfter(int offset)
    Get the next data item starting after offset.
    getDataBefore(int offset)
    Get the previous data item starting before offset.
    int
    getNextOffset(int offset)
    Get the offset to the next data item found after offset.
    int
    getPreviousOffset(int offset)
    Get the offset to the previous data item existing before this offset.
  • Method Details

    • getData

      Data getData(int offset)
      Get one Data item from the buffer at the current position plus offset.
      Parameters:
      offset - the displacement from the current position.
      Returns:
      the Data item at offset from the current position.
      Throws:
      AddressOutOfBoundsException - if offset exceeds address space
      IndexOutOfBoundsException - if offset is negative
    • getDataAfter

      Data getDataAfter(int offset)
      Get the next data item starting after offset.
      Parameters:
      offset - offset to look after
      Returns:
      Data item starting after this offset
    • getDataBefore

      Data getDataBefore(int offset)
      Get the previous data item starting before offset.
      Parameters:
      offset - offset to look before
      Returns:
      Data item starting before this offset
    • getNextOffset

      int getNextOffset(int offset)
      Get the offset to the next data item found after offset.
      Parameters:
      offset - offset to look after
      Returns:
      offset of the first data item existing after this one.
    • getPreviousOffset

      int getPreviousOffset(int offset)
      Get the offset to the previous data item existing before this offset.
      Parameters:
      offset - offset to look before
      Returns:
      offset of the first data item existing before this one.
    • getData

      Data[] getData(int start, int end)
      Get an array of data items that begin at or after start up to end. Data items that exist before start are not returned Data items that exist before end, but terminate after end ARE returned
      Parameters:
      start - start offset
      end - end offset
      Returns:
      array of CodeDatas that exist between start and end.
    • getAddress

      Address getAddress()
      Get the Address which corresponds to the offset 0.
      Returns:
      the current address of offset 0.