Class SourceRange

java.lang.Object
org.eclipse.jdt.core.SourceRange
All Implemented Interfaces:
ISourceRange

public final class SourceRange extends Object implements ISourceRange
A source range defines an element's source coordinates relative to its source buffer.
Since:
3.6
See Also:
  • Constructor Summary

    Constructors
    Constructor
    Description
    SourceRange(int offset, int length)
    Instantiate a new source range using the given offset and the given length.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
     
    int
    Returns the number of characters of the source code for this element, relative to the source buffer in which this element is contained.
    int
    Returns the 0-based index of the first character of the source code for this element, relative to the source buffer in which this element is contained.
    int
     
    static boolean
    Helper method that answers whether a valid source range is available in the given ISourceRange.
     

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • SourceRange

      public SourceRange(int offset, int length)
      Instantiate a new source range using the given offset and the given length.
      Parameters:
      offset - the given offset
      length - the given length
  • Method Details

    • isAvailable

      public static boolean isAvailable(ISourceRange range)
      Helper method that answers whether a valid source range is available in the given ISourceRange. When an element has no associated source code, Java Model APIs may return either null or a range of [-1, 0] to indicate an invalid range. This utility method can be used to detect that case.
      Parameters:
      range - a source range, can be null
      Returns:
      true iff range is not null and range.getOffset() is not -1
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object
    • getLength

      public int getLength()
      Description copied from interface: ISourceRange
      Returns the number of characters of the source code for this element, relative to the source buffer in which this element is contained.
      Specified by:
      getLength in interface ISourceRange
      Returns:
      the number of characters of the source code for this element, relative to the source buffer in which this element is contained
      See Also:
    • getOffset

      public int getOffset()
      Description copied from interface: ISourceRange
      Returns the 0-based index of the first character of the source code for this element, relative to the source buffer in which this element is contained. However, if the element has no associated source code, an implementation may return -1.
      Specified by:
      getOffset in interface ISourceRange
      Returns:
      the 0-based index of the first character of the source code for this element, relative to the source buffer in which this element is contained. However, if the element has no associated source code, an implementation may return -1.
      See Also:
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object