Class TreeRangeSet<C extends Comparable<?>>
- java.lang.Object
-
- com.google.common.collect.TreeRangeSet<C>
-
- All Implemented Interfaces:
RangeSet<C>
@Beta @GwtIncompatible("uses NavigableMap") public class TreeRangeSet<C extends Comparable<?>> extends Object
- Since:
- 14.0
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description voidadd(Range<C> rangeToAdd)Adds the specified range to thisRangeSet(optional operation).voidaddAll(RangeSet<C> other)Adds all of the ranges from the specified range set to this range set (optional operation).Set<Range<C>>asRanges()Returns a view of the disconnected ranges that make up this range set.voidclear()Removes all ranges from thisRangeSet(optional operation).RangeSet<C>complement()Returns a view of the complement of thisRangeSet.booleancontains(C value)Determines whether any of this range set's member ranges containsvalue.static <C extends Comparable<?>>
TreeRangeSet<C>create()Creates an emptyTreeRangeSetinstance.static <C extends Comparable<?>>
TreeRangeSet<C>create(RangeSet<C> rangeSet)Returns aTreeRangeSetinitialized with the ranges in the specified range set.booleanencloses(Range<C> range)Returnstrueif there exists a member range in this range set which encloses the specified range.booleanenclosesAll(RangeSet<C> other)Returnstrueif for each member range inotherthere exists a member range in this range set which encloses it.booleanequals(Object obj)Returnstrueifobjis anotherRangeSetthat contains the same ranges according toRange.equals(Object).inthashCode()ReturnsasRanges().hashCode().booleanisEmpty()Returnstrueif this range set contains no ranges.Range<C>rangeContaining(C value)Returns the unique range from this range set that containsvalue, ornullif this range set does not containvalue.voidremove(Range<C> rangeToRemove)Removes the specified range from thisRangeSet(optional operation).voidremoveAll(RangeSet<C> other)Removes all of the ranges from the specified range set from this range set (optional operation).Range<C>span()Returns the minimal range which encloses all ranges in this range set.RangeSet<C>subRangeSet(Range<C> view)Returns a view of the intersection of thisRangeSetwith the specified range.StringtoString()Returns a readable string representation of this range set.
-
-
-
Method Detail
-
create
public static <C extends Comparable<?>> TreeRangeSet<C> create()
Creates an emptyTreeRangeSetinstance.
-
create
public static <C extends Comparable<?>> TreeRangeSet<C> create(RangeSet<C> rangeSet)
Returns aTreeRangeSetinitialized with the ranges in the specified range set.
-
asRanges
public Set<Range<C>> asRanges()
Description copied from interface:RangeSetReturns a view of the disconnected ranges that make up this range set. The returned set may be empty. The iterators returned by itsIterable.iterator()method return the ranges in increasing order of lower bound (equivalently, of upper bound).
-
rangeContaining
@Nullable public Range<C> rangeContaining(C value)
Description copied from interface:RangeSetReturns the unique range from this range set that containsvalue, ornullif this range set does not containvalue.- Specified by:
rangeContainingin interfaceRangeSet<C extends Comparable<?>>
-
encloses
public boolean encloses(Range<C> range)
Description copied from interface:RangeSetReturnstrueif there exists a member range in this range set which encloses the specified range.- Specified by:
enclosesin interfaceRangeSet<C extends Comparable<?>>
-
span
public Range<C> span()
Description copied from interface:RangeSetReturns the minimal range which encloses all ranges in this range set.
-
add
public void add(Range<C> rangeToAdd)
Description copied from interface:RangeSetAdds the specified range to thisRangeSet(optional operation). That is, for equal range sets a and b, the result ofa.add(range)is thatawill be the minimal range set for which botha.enclosesAll(b)anda.encloses(range).Note that
rangewill be coalesced with any ranges in the range set that are connected with it. Moreover, ifrangeis empty, this is a no-op.- Specified by:
addin interfaceRangeSet<C extends Comparable<?>>
-
remove
public void remove(Range<C> rangeToRemove)
Description copied from interface:RangeSetRemoves the specified range from thisRangeSet(optional operation). After this operation, ifrange.contains(c),this.contains(c)will returnfalse.If
rangeis empty, this is a no-op.- Specified by:
removein interfaceRangeSet<C extends Comparable<?>>
-
complement
public RangeSet<C> complement()
Description copied from interface:RangeSetReturns a view of the complement of thisRangeSet.The returned view supports the
RangeSet.add(com.google.common.collect.Range<C>)operation if thisRangeSetsupportsRangeSet.remove(com.google.common.collect.Range<C>), and vice versa.
-
subRangeSet
public RangeSet<C> subRangeSet(Range<C> view)
Description copied from interface:RangeSetReturns a view of the intersection of thisRangeSetwith the specified range.The returned view supports all optional operations supported by this
RangeSet, with the caveat that anIllegalArgumentExceptionis thrown on an attempt to add any range not enclosed byview.
-
contains
public boolean contains(C value)
Description copied from interface:RangeSetDetermines whether any of this range set's member ranges containsvalue.- Specified by:
containsin interfaceRangeSet<C extends Comparable>
-
isEmpty
public boolean isEmpty()
Description copied from interface:RangeSetReturnstrueif this range set contains no ranges.- Specified by:
isEmptyin interfaceRangeSet<C extends Comparable>
-
clear
public void clear()
Description copied from interface:RangeSetRemoves all ranges from thisRangeSet(optional operation). After this operation,this.contains(c)will return false for allc.This is equivalent to
remove(Range.all()).- Specified by:
clearin interfaceRangeSet<C extends Comparable>
-
enclosesAll
public boolean enclosesAll(RangeSet<C> other)
Description copied from interface:RangeSetReturnstrueif for each member range inotherthere exists a member range in this range set which encloses it. It follows thatthis.contains(value)wheneverother.contains(value). Returnstrueifotheris empty.This is equivalent to checking if this range set
RangeSet.encloses(com.google.common.collect.Range<C>)each of the ranges inother.- Specified by:
enclosesAllin interfaceRangeSet<C extends Comparable>
-
addAll
public void addAll(RangeSet<C> other)
Description copied from interface:RangeSetAdds all of the ranges from the specified range set to this range set (optional operation). After this operation, this range set is the minimal range set that encloses both the original range set andother.This is equivalent to calling
RangeSet.add(com.google.common.collect.Range<C>)on each of the ranges inotherin turn.- Specified by:
addAllin interfaceRangeSet<C extends Comparable>
-
removeAll
public void removeAll(RangeSet<C> other)
Description copied from interface:RangeSetRemoves all of the ranges from the specified range set from this range set (optional operation). After this operation, ifother.contains(c),this.contains(c)will returnfalse.This is equivalent to calling
RangeSet.remove(com.google.common.collect.Range<C>)on each of the ranges inotherin turn.- Specified by:
removeAllin interfaceRangeSet<C extends Comparable>
-
equals
public boolean equals(@Nullable Object obj)
Description copied from interface:RangeSetReturnstrueifobjis anotherRangeSetthat contains the same ranges according toRange.equals(Object).- Specified by:
equalsin interfaceRangeSet<C extends Comparable>- Overrides:
equalsin classObject
-
hashCode
public final int hashCode()
Description copied from interface:RangeSetReturnsasRanges().hashCode().- Specified by:
hashCodein interfaceRangeSet<C extends Comparable>- Overrides:
hashCodein classObject
-
toString
public final String toString()
Description copied from interface:RangeSetReturns a readable string representation of this range set. For example, if thisRangeSetconsisted ofRange.closed(1, 3)andRange.greaterThan(4), this might return" [1‥3](4‥+∞)"}.- Specified by:
toStringin interfaceRangeSet<C extends Comparable>- Overrides:
toStringin classObject
-
-