com.google.common.collect.ContiguousSet<C>

All Implemented Interfaces:: Serializable, Iterable<C>, Collection<C>, NavigableSet<C>, SequencedCollection<C>, SequencedSet<C>, Set<C>, SortedSet<C>

@Beta @GwtCompatible(emulated=true) @Deprecated(since="2022-12-01") public abstract class ContiguousSet<C extends Comparable> extends ImmutableSortedSet<C>

Deprecated.

The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023

A sorted set of contiguous values in a given DiscreteDomain.

Warning: Be extremely careful what you do with conceptually large instances (such as ContiguousSet.create(Range.greaterThan(0), DiscreteDomain.integers()). Certain operations on such a set can be performed efficiently, but others (such as Set.hashCode() or Collections.frequency(java.util.Collection<?>, java.lang.Object)) can cause major performance problems.

Since:

10.0

See Also:

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.collect.ImmutableSortedSet
ImmutableSortedSet.Builder<E>
Method Summary

Modifier and Type

Method

Description

static <E> ImmutableSortedSet.Builder<E>

builder()

Deprecated.
Use create(com.google.common.collect.Range<C>, com.google.common.collect.DiscreteDomain<C>).

static <E> ImmutableSortedSet<E>

copyOf(E[] elements)

Deprecated.
Pass parameters of type Comparable to use ImmutableSortedSet.copyOf(Comparable[]).

static <C extends Comparable> ContiguousSet<C>

create(Range<C> range, DiscreteDomain<C> domain)

Deprecated.

Returns a ContiguousSet containing the same values in the given domain contained by the range.

ContiguousSet<C>

headSet(C toElement)

Deprecated.

ContiguousSet<C>

headSet(C toElement, boolean inclusive)

Deprecated.

abstract ContiguousSet<C>

intersection(ContiguousSet<C> other)

Deprecated.

Returns the set of values that are contained in both this set and the other.

static <E> ImmutableSortedSet<E>

of(E element)

Deprecated.
Pass a parameter of type Comparable to use ImmutableSortedSet.of(Comparable).

static <E> ImmutableSortedSet<E>

of(E e1, E e2)

Deprecated.
Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable).

static <E> ImmutableSortedSet<E>

of(E e1, E e2, E e3)

Deprecated.
Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable).

static <E> ImmutableSortedSet<E>

of(E e1, E e2, E e3, E e4)

Deprecated.
Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable).

static <E> ImmutableSortedSet<E>

of(E e1, E e2, E e3, E e4, E e5)

Deprecated.
Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable).

static <E> ImmutableSortedSet<E>

of(E e1, E e2, E e3, E e4, E e5, E e6, E... remaining)

Deprecated.
Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable, Comparable, Comparable...).

abstract Range<C>

range()

Deprecated.

Returns a range, closed on both ends, whose endpoints are the minimum and maximum values contained in this set.

abstract Range<C>

range(BoundType lowerBoundType, BoundType upperBoundType)

Deprecated.

Returns the minimal range with the given boundary types for which all values in this set are contained within the range.

ContiguousSet<C>

subSet(C fromElement, boolean fromInclusive, C toElement, boolean toInclusive)

Deprecated.

ContiguousSet<C>

subSet(C fromElement, C toElement)

Deprecated.

ContiguousSet<C>

tailSet(C fromElement)

Deprecated.

ContiguousSet<C>

tailSet(C fromElement, boolean inclusive)

Deprecated.

String

toString()

Deprecated.

Returns a short-hand representation of the contents such as "[1..100]".

Methods inherited from class com.google.common.collect.ImmutableSortedSet
ceiling, comparator, copyOf, copyOf, copyOf, copyOf, copyOf, copyOf, copyOf, copyOfSorted, descendingIterator, descendingSet, first, floor, higher, iterator, last, lower, naturalOrder, of, of, of, of, of, of, of, orderedBy, pollFirst, pollLast, reverseOrder

Methods inherited from class com.google.common.collect.ImmutableSet
equals, hashCode

Methods inherited from class com.google.common.collect.ImmutableCollection
add, addAll, asList, clear, contains, remove, removeAll, retainAll, toArray, toArray

Methods inherited from class java.util.AbstractCollection
containsAll, isEmpty, size

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable
forEach

Methods inherited from interface java.util.NavigableSet
removeFirst, removeLast, reversed

Methods inherited from interface java.util.Set
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, remove, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface java.util.SortedSet
addFirst, addLast, getFirst, getLast, spliterator

Method Details
- create
  
  public static <C extends Comparable> ContiguousSet<C> create(Range<C> range, DiscreteDomain<C> domain)
  
  Deprecated.
  
  Returns a ContiguousSet containing the same values in the given domain contained by the range.
  
  Throws:
  
  IllegalArgumentException - if neither range nor the domain has a lower bound, or if neither has an upper bound
  
  Since:
  
  13.0
- headSet
  
  public ContiguousSet<C> headSet(C toElement)
  
  Deprecated.
  
  Description copied from class: ImmutableSortedSet
  
  This method returns a serializable ImmutableSortedSet.
  The SortedSet.headSet(E) documentation states that a subset of a subset throws an IllegalArgumentException if passed a toElement greater than an earlier toElement. However, this method doesn't throw an exception in that situation, but instead keeps the original toElement.
  
  Specified by:
  
  headSet in interface NavigableSet<C extends Comparable>
  
  Specified by:
  
  headSet in interface SortedSet<C extends Comparable>
  
  Overrides:
  
  headSet in class ImmutableSortedSet<C extends Comparable>
- headSet
  
  @GwtIncompatible("NavigableSet") public ContiguousSet<C> headSet(C toElement, boolean inclusive)
  
  Deprecated.
  
  Specified by:
  
  headSet in interface NavigableSet<C extends Comparable>
  
  Overrides:
  
  headSet in class ImmutableSortedSet<C extends Comparable>
  
  Since:
  
  12.0
- subSet
  
  public ContiguousSet<C> subSet(C fromElement, C toElement)
  
  Deprecated.
  
  Description copied from class: ImmutableSortedSet
  
  This method returns a serializable ImmutableSortedSet.
  The SortedSet.subSet(E, E) documentation states that a subset of a subset throws an IllegalArgumentException if passed a fromElement smaller than an earlier fromElement. However, this method doesn't throw an exception in that situation, but instead keeps the original fromElement. Similarly, this method keeps the original toElement, instead of throwing an exception, if passed a toElement greater than an earlier toElement.
  
  Specified by:
  
  subSet in interface NavigableSet<C extends Comparable>
  
  Specified by:
  
  subSet in interface SortedSet<C extends Comparable>
  
  Overrides:
  
  subSet in class ImmutableSortedSet<C extends Comparable>
- subSet
  
  @GwtIncompatible("NavigableSet") public ContiguousSet<C> subSet(C fromElement, boolean fromInclusive, C toElement, boolean toInclusive)
  
  Deprecated.
  
  Specified by:
  
  subSet in interface NavigableSet<C extends Comparable>
  
  Overrides:
  
  subSet in class ImmutableSortedSet<C extends Comparable>
  
  Since:
  
  12.0
- tailSet
  
  public ContiguousSet<C> tailSet(C fromElement)
  
  Deprecated.
  
  Description copied from class: ImmutableSortedSet
  
  This method returns a serializable ImmutableSortedSet.
  The SortedSet.tailSet(E) documentation states that a subset of a subset throws an IllegalArgumentException if passed a fromElement smaller than an earlier fromElement. However, this method doesn't throw an exception in that situation, but instead keeps the original fromElement.
  
  Specified by:
  
  tailSet in interface NavigableSet<C extends Comparable>
  
  Specified by:
  
  tailSet in interface SortedSet<C extends Comparable>
  
  Overrides:
  
  tailSet in class ImmutableSortedSet<C extends Comparable>
- tailSet
  
  @GwtIncompatible("NavigableSet") public ContiguousSet<C> tailSet(C fromElement, boolean inclusive)
  
  Deprecated.
  
  Specified by:
  
  tailSet in interface NavigableSet<C extends Comparable>
  
  Overrides:
  
  tailSet in class ImmutableSortedSet<C extends Comparable>
  
  Since:
  
  12.0
- intersection
  
  public abstract ContiguousSet<C> intersection(ContiguousSet<C> other)
  
  Deprecated.
  
  Returns the set of values that are contained in both this set and the other.
  This method should always be used instead of Sets.intersection(java.util.Set<E>, java.util.Set<?>) for ContiguousSet instances.
- range
  
  public abstract Range<C> range()
  
  Deprecated.
  
  Returns a range, closed on both ends, whose endpoints are the minimum and maximum values contained in this set. This is equivalent to range(CLOSED, CLOSED).
  
  Throws:
  
  NoSuchElementException - if this set is empty
- range
  
  public abstract Range<C> range(BoundType lowerBoundType, BoundType upperBoundType)
  
  Deprecated.
  
  Returns the minimal range with the given boundary types for which all values in this set are contained within the range.
  Note that this method will return ranges with unbounded endpoints if BoundType.OPEN is requested for a domain minimum or maximum. For example, if set was created from the range [1..Integer.MAX_VALUE] then set.range(CLOSED, OPEN) must return [1..∞).
  
  Throws:
  
  NoSuchElementException - if this set is empty
- toString
  
  public String toString()
  
  Deprecated.
  
  Returns a short-hand representation of the contents such as "[1..100]".
  
  Overrides:
  
  toString in class AbstractCollection<C extends Comparable>
- builder
  
  @Deprecated public static <E> ImmutableSortedSet.Builder<E> builder()
  
  Deprecated.
  Use create(com.google.common.collect.Range<C>, com.google.common.collect.DiscreteDomain<C>).
  
  Not supported. ContiguousSet instances are constructed with create(com.google.common.collect.Range<C>, com.google.common.collect.DiscreteDomain<C>). This method exists only to hide ImmutableSet.builder() from consumers of ContiguousSet.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E element)
  
  Deprecated.
  Pass a parameter of type Comparable to use ImmutableSortedSet.of(Comparable).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E e1, E e2)
  
  Deprecated.
  Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3)
  
  Deprecated.
  Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4)
  
  Deprecated.
  Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4, E e5)
  
  Deprecated.
  Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- of
  
  @Deprecated public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E... remaining)
  
  Deprecated.
  Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable, Comparable, Comparable...).
  
  Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always
- copyOf
  
  @Deprecated public static <E> ImmutableSortedSet<E> copyOf(E[] elements)
  
  Deprecated.
  Pass parameters of type Comparable to use ImmutableSortedSet.copyOf(Comparable[]).
  
  Not supported. You are attempting to create a set that may contain non-Comparable elements. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
  
  Throws:
  
  UnsupportedOperationException - always

Class ContiguousSet<C extends Comparable>

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.collect.ImmutableSortedSet

Method Summary

Methods inherited from class com.google.common.collect.ImmutableSortedSet

Methods inherited from class com.google.common.collect.ImmutableSet

Methods inherited from class com.google.common.collect.ImmutableCollection

Methods inherited from class java.util.AbstractCollection

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Methods inherited from interface java.util.NavigableSet

Methods inherited from interface java.util.Set

Methods inherited from interface java.util.SortedSet

Method Details

create

headSet

headSet

subSet

subSet

tailSet

tailSet

intersection

range

range

toString

builder

of

of

of

of

of

of

copyOf