Class Range


  • public class Range
    extends java.lang.Object
    A Range object tracks the character positions in the original input source where a Node starts or ends. If you want to track these positions, tracking must be enabled in the Parser with Parser.setTrackPosition(boolean).
    Since:
    1.15.2
    See Also:
    Node.sourceRange()
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  Range.Position
      A Position object tracks the character position in the original input source where a Node starts or ends.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      Range.Position end()
      Get the end position of this node.
      boolean equals​(java.lang.Object o)  
      int hashCode()  
      boolean isTracked()
      Test if this source range was tracked during parsing.
      Range.Position start()
      Get the start position of this node.
      java.lang.String toString()
      Gets a String presentation of this Range, in the format line,column:pos-line,column:pos.
      void track​(Node node, boolean start)
      Internal jsoup method, called by the TreeBuilder.
      • Methods inherited from class java.lang.Object

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

      • Range

        public Range​(Range.Position start,
                     Range.Position end)
        Creates a new Range with start and end Positions. Called by TreeBuilder when position tracking is on.
        Parameters:
        start - the start position
        end - the end position
    • Method Detail

      • start

        public Range.Position start()
        Get the start position of this node.
        Returns:
        the start position
      • end

        public Range.Position end()
        Get the end position of this node.
        Returns:
        the end position
      • isTracked

        public boolean isTracked()
        Test if this source range was tracked during parsing.
        Returns:
        true if this was tracked during parsing, false otherwise (and all fields will be -1).
      • track

        public void track​(Node node,
                          boolean start)
        Internal jsoup method, called by the TreeBuilder. Tracks a Range for a Node.
        Parameters:
        node - the node to associate this position to
        start - if this is the starting range. false for Element end tags.
      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object
      • hashCode

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

        public java.lang.String toString()
        Gets a String presentation of this Range, in the format line,column:pos-line,column:pos.
        Overrides:
        toString in class java.lang.Object
        Returns:
        a String