| Modifier and Type | Field and Description |
|---|---|
static long |
serialVersionUID |
| Modifier and Type | Method and Description |
|---|---|
SortedSet<T> |
add(T element)
Add the given element to this set, if it is not already contained.
|
SortedSet<T> |
addAll(java.lang.Iterable<? extends T> elements)
Adds all of the given elements to this set, if not already contained.
|
<R> SortedSet<R> |
collect(PartialFunction<? super T,? extends R> partialFunction)
Collects all elements that are in the domain of the given
partialFunction by mapping the elements to type R. |
SortedSet<T> |
diff(Set<? extends T> elements)
Calculates the difference between this set and another set.
|
SortedSet<T> |
distinct()
Returns a new version of this which contains no duplicates.
|
SortedSet<T> |
distinctBy(java.util.Comparator<? super T> comparator)
Returns a new version of this which contains no duplicates.
|
<U> SortedSet<T> |
distinctBy(java.util.function.Function<? super T,? extends U> keyExtractor)
Returns a new version of this which contains no duplicates.
|
SortedSet<T> |
drop(int n)
Drops the first n elements of this or all elements, if this length < n.
|
SortedSet<T> |
dropRight(int n)
Drops the last n elements of this or all elements, if this length < n.
|
SortedSet<T> |
dropUntil(java.util.function.Predicate<? super T> predicate)
Drops elements until the predicate holds for the current element.
|
SortedSet<T> |
dropWhile(java.util.function.Predicate<? super T> predicate)
Drops elements while the predicate holds for the current element.
|
SortedSet<T> |
filter(java.util.function.Predicate<? super T> predicate)
Returns a new traversable consisting of all elements which satisfy the given predicate.
|
SortedSet<T> |
filterNot(java.util.function.Predicate<? super T> predicate)
Returns a new traversable consisting of all elements which do not satisfy the given predicate.
|
<U> SortedSet<U> |
flatMap(java.util.Comparator<? super U> comparator,
java.util.function.Function<? super T,? extends java.lang.Iterable<? extends U>> mapper)
Same as
flatMap(Function) but using a specific comparator for values of the codomain of the given
mapper. |
<U> Set<U> |
flatMap(java.util.function.Function<? super T,? extends java.lang.Iterable<? extends U>> mapper)
FlatMaps this Traversable.
|
<C> Map<C,? extends SortedSet<T>> |
groupBy(java.util.function.Function<? super T,? extends C> classifier)
Groups this elements by classifying the elements.
|
Iterator<? extends SortedSet<T>> |
grouped(int size)
Groups this
Traversable into fixed size blocks. |
SortedSet<T> |
init()
Dual of Traversable.tail(), returning all elements except the last.
|
Option<? extends SortedSet<T>> |
initOption()
Dual of Traversable.tailOption(), returning all elements except the last as
Option. |
SortedSet<T> |
intersect(Set<? extends T> elements)
Computes the intersection between this set and another set.
|
default boolean |
isOrdered()
Checks if this Traversable is ordered
|
<U> SortedSet<U> |
map(java.util.Comparator<? super U> comparator,
java.util.function.Function<? super T,? extends U> mapper)
Same as
map(Function) but using a specific comparator for values of the codomain of the given
mapper. |
<U> Set<U> |
map(java.util.function.Function<? super T,? extends U> mapper)
Maps the elements of this
Traversable to elements of a new type preserving their order, if any. |
static <T> SortedSet<T> |
narrow(SortedSet<? extends T> sortedSet)
Narrows a widened
SortedSet<? extends T> to SortedSet<T>
by performing a type-safe cast. |
SortedSet<T> |
orElse(java.lang.Iterable<? extends T> other)
Returns this
Traversable if it is nonempty, otherwise return the alternative. |
SortedSet<T> |
orElse(java.util.function.Supplier<? extends java.lang.Iterable<? extends T>> supplier)
Returns this
Traversable if it is nonempty, otherwise return the result of evaluating supplier. |
Tuple2<? extends SortedSet<T>,? extends SortedSet<T>> |
partition(java.util.function.Predicate<? super T> predicate)
Creates a partition of this
Traversable by splitting this elements in two in distinct traversables
according to a predicate. |
SortedSet<T> |
peek(java.util.function.Consumer<? super T> action)
Performs the given
action on the first element if this is an eager implementation. |
SortedSet<T> |
remove(T element)
Removes a specific element from this set, if present.
|
SortedSet<T> |
removeAll(java.lang.Iterable<? extends T> elements)
Removes all of the given elements from this set, if present.
|
SortedSet<T> |
replace(T currentElement,
T newElement)
Replaces the first occurrence (if exists) of the given currentElement with newElement.
|
SortedSet<T> |
replaceAll(T currentElement,
T newElement)
Replaces all occurrences of the given currentElement with newElement.
|
SortedSet<T> |
retainAll(java.lang.Iterable<? extends T> elements)
Keeps all occurrences of the given elements from this.
|
SortedSet<T> |
scan(T zero,
java.util.function.BiFunction<? super T,? super T,? extends T> operation)
Computes a prefix scan of the elements of the collection.
|
<U> Set<U> |
scanLeft(U zero,
java.util.function.BiFunction<? super U,? super T,? extends U> operation)
Produces a collection containing cumulative results of applying the
operator going left to right.
|
<U> Set<U> |
scanRight(U zero,
java.util.function.BiFunction<? super T,? super U,? extends U> operation)
Produces a collection containing cumulative results of applying the
operator going right to left.
|
Iterator<? extends SortedSet<T>> |
slideBy(java.util.function.Function<? super T,?> classifier)
Slides a non-overlapping window of a variable size over this
Traversable. |
Iterator<? extends SortedSet<T>> |
sliding(int size)
Slides a window of a specific
size and step size 1 over this Traversable by calling
Traversable.sliding(int, int). |
Iterator<? extends SortedSet<T>> |
sliding(int size,
int step)
Slides a window of a specific
size and step size over this Traversable. |
Tuple2<? extends SortedSet<T>,? extends SortedSet<T>> |
span(java.util.function.Predicate<? super T> predicate)
Returns a tuple where the first element is the longest prefix of elements that satisfy the given
predicate and the second element is the remainder. |
SortedSet<T> |
tail()
Drops the first element of a non-empty Traversable.
|
Option<? extends SortedSet<T>> |
tailOption()
Drops the first element of a non-empty Traversable and returns an
Option. |
SortedSet<T> |
take(int n)
Takes the first n elements of this or all elements, if this length < n.
|
SortedSet<T> |
takeRight(int n)
Takes the last n elements of this or all elements, if this length < n.
|
SortedSet<T> |
takeUntil(java.util.function.Predicate<? super T> predicate)
Takes elements until the predicate holds for the current element.
|
SortedSet<T> |
takeWhile(java.util.function.Predicate<? super T> predicate)
Takes elements while the predicate holds for the current element.
|
java.util.SortedSet<T> |
toJavaSet()
Converts this Vavr
Set to a java.util.Set while preserving characteristics
like insertion order (LinkedHashSet) and sort order (SortedSet). |
SortedSet<T> |
union(Set<? extends T> elements)
Adds all of the elements of
that set to this set, if not already present. |
<U> SortedSet<Tuple2<T,U>> |
zip(java.lang.Iterable<? extends U> that)
Returns a traversable formed from this traversable and another Iterable collection by combining
corresponding elements in pairs.
|
<U> SortedSet<Tuple2<T,U>> |
zipAll(java.lang.Iterable<? extends U> that,
T thisElem,
U thatElem)
Returns a traversable formed from this traversable and another Iterable by combining corresponding elements in
pairs.
|
<U,R> SortedSet<R> |
zipWith(java.lang.Iterable<? extends U> that,
java.util.function.BiFunction<? super T,? super U,? extends R> mapper)
Returns a traversable formed from this traversable and another Iterable collection by mapping elements.
|
SortedSet<Tuple2<T,java.lang.Integer>> |
zipWithIndex()
Zips this traversable with its indices.
|
<U> SortedSet<U> |
zipWithIndex(java.util.function.BiFunction<? super T,? super java.lang.Integer,? extends U> mapper)
Zips this traversable with its indices by applying mapper provided.
|
contains, isDistinct, iterator, length, narrowarrangeBy, average, containsAll, count, equals, existsUnique, find, findLast, fold, foldLeft, foldRight, forEachWithIndex, get, hasDefiniteSize, hashCode, head, headOption, isEmpty, isSequential, isSingleValued, isTraversableAgain, last, lastOption, max, maxBy, maxBy, min, minBy, minBy, mkCharSeq, mkCharSeq, mkCharSeq, mkString, mkString, mkString, narrow, nonEmpty, product, reduce, reduceLeft, reduceLeftOption, reduceOption, reduceRight, reduceRightOption, single, singleOption, size, spliterator, sum, toLinkedMap, toMap, toSortedMap, toSortedMap, unzip, unzip3collect, collect, corresponds, eq, exists, forAll, forEach, getOrElse, getOrElse, getOrElseThrow, getOrElseTry, getOrNull, isAsync, isLazy, narrow, out, out, stderr, stdout, stringPrefix, toArray, toCharSeq, toCompletableFuture, toEither, toEither, toInvalid, toInvalid, toJavaArray, toJavaArray, toJavaArray, toJavaCollection, toJavaList, toJavaList, toJavaMap, toJavaMap, toJavaMap, toJavaOptional, toJavaParallelStream, toJavaSet, toJavaStream, toLeft, toLeft, toLinkedMap, toLinkedMap, toLinkedSet, toList, toMap, toMap, toOption, toPriorityQueue, toPriorityQueue, toQueue, toRight, toRight, toSet, toSortedMap, toSortedMap, toSortedMap, toSortedMap, toSortedSet, toSortedSet, toStream, toString, toTree, toTree, toTry, toTry, toValid, toValid, toValidation, toValidation, toVectorcomparatorstatic final long serialVersionUID
static <T> SortedSet<T> narrow(SortedSet<? extends T> sortedSet)
SortedSet<? extends T> to SortedSet<T>
by performing a type-safe cast. This is eligible because immutable/read-only
collections are covariant.
CAUTION: The underlying Comparator might fail!
T - Component type of the SortedSet.sortedSet - A SortedSet.sortedSet instance as narrowed type SortedSet<T>.<U> SortedSet<U> flatMap(java.util.Comparator<? super U> comparator, java.util.function.Function<? super T,? extends java.lang.Iterable<? extends U>> mapper)
flatMap(Function) but using a specific comparator for values of the codomain of the given
mapper.U - Type of flat-mapped valuescomparator - A comparator for values of type Umapper - A function which maps values of type T to Iterables of values of type U<U> SortedSet<U> map(java.util.Comparator<? super U> comparator, java.util.function.Function<? super T,? extends U> mapper)
map(Function) but using a specific comparator for values of the codomain of the given
mapper.U - Type of mapped valuescomparator - A comparator for values of type Umapper - A function which maps values of type T to values of type USortedSet<T> add(T element)
SetSortedSet<T> addAll(java.lang.Iterable<? extends T> elements)
Set<R> SortedSet<R> collect(PartialFunction<? super T,? extends R> partialFunction)
TraversablepartialFunction by mapping the elements to type R.
More specifically, for each of this elements in iteration order first it is checked
partialFunction.isDefinedAt(element)
If the elements makes it through that filter, the mapped instance is added to the result collection
R newElement = partialFunction.apply(element)
Note:If this Traversable is ordered (i.e. extends Ordered,
the caller of collect has to ensure that the elements are comparable (i.e. extend Comparable).collect in interface Set<T>collect in interface Traversable<T>R - The new element typepartialFunction - A function that is not necessarily defined of all elements of this traversable.Traversable instance containing elements of type RSortedSet<T> diff(Set<? extends T> elements)
Set
See also Set.removeAll(Iterable).
SortedSet<T> distinct()
Traversableequals.SortedSet<T> distinctBy(java.util.Comparator<? super T> comparator)
Traversablecomparator.distinctBy in interface Set<T>distinctBy in interface Traversable<T>comparator - A comparatorTraversable containing this elements without duplicates<U> SortedSet<T> distinctBy(java.util.function.Function<? super T,? extends U> keyExtractor)
Traversableequals.
The elements of the result are determined in the order of their occurrence - first match wins.
distinctBy in interface Set<T>distinctBy in interface Traversable<T>U - key typekeyExtractor - A key extractorTraversable containing this elements without duplicatesSortedSet<T> drop(int n)
TraversableSortedSet<T> dropRight(int n)
TraversableSortedSet<T> dropUntil(java.util.function.Predicate<? super T> predicate)
TraversableSortedSet<T> dropWhile(java.util.function.Predicate<? super T> predicate)
Traversable
Note: This is essentially the same as dropUntil(predicate.negate()).
It is intended to be used with method references, which cannot be negated directly.
SortedSet<T> filter(java.util.function.Predicate<? super T> predicate)
TraversableSortedSet<T> filterNot(java.util.function.Predicate<? super T> predicate)
TraversableThe default implementation is equivalent to
filter(predicate.negate()<U> Set<U> flatMap(java.util.function.Function<? super T,? extends java.lang.Iterable<? extends U>> mapper)
Traversable<C> Map<C,? extends SortedSet<T>> groupBy(java.util.function.Function<? super T,? extends C> classifier)
TraversablegroupBy in interface Set<T>groupBy in interface Traversable<T>C - classified class typeclassifier - A function which classifies elements into classesTraversable.arrangeBy(Function)Iterator<? extends SortedSet<T>> grouped(int size)
TraversableTraversable into fixed size blocks.
Let length be the length of this Iterable. Then grouped is defined as follows:
this.isEmpty(), the resulting Iterator is empty.size <= length, the resulting Iterator will contain length / size blocks of size
size and maybe a non-empty block of size length % size, if there are remaining elements.size > length, the resulting Iterator will contain one block of size length.
[].grouped(1) = []
[].grouped(0) throws
[].grouped(-1) throws
[1,2,3,4].grouped(2) = [[1,2],[3,4]]
[1,2,3,4,5].grouped(2) = [[1,2],[3,4],[5]]
[1,2,3,4].grouped(5) = [[1,2,3,4]]
Please note that grouped(int) is a special case of Traversable.sliding(int, int), i.e.
grouped(size) is the same as sliding(size, size).SortedSet<T> init()
TraversableOption<? extends SortedSet<T>> initOption()
TraversableOption.initOption in interface Set<T>initOption in interface Traversable<T>Some(traversable) or None if this is empty.SortedSet<T> intersect(Set<? extends T> elements)
Set
See also Set.retainAll(Iterable).
default boolean isOrdered()
TraversableisOrdered in interface Traversable<T><U> Set<U> map(java.util.function.Function<? super T,? extends U> mapper)
TraversableTraversable to elements of a new type preserving their order, if any.SortedSet<T> orElse(java.lang.Iterable<? extends T> other)
TraversableTraversable if it is nonempty, otherwise return the alternative.SortedSet<T> orElse(java.util.function.Supplier<? extends java.lang.Iterable<? extends T>> supplier)
TraversableTraversable if it is nonempty, otherwise return the result of evaluating supplier.Tuple2<? extends SortedSet<T>,? extends SortedSet<T>> partition(java.util.function.Predicate<? super T> predicate)
TraversableTraversable by splitting this elements in two in distinct traversables
according to a predicate.partition in interface Set<T>partition in interface Traversable<T>predicate - A predicate which classifies an element if it is in the first or the second traversable.Traversable contains all elements that satisfy the given predicate, the second Traversable contains all elements that don't. The original order of elements is preserved.SortedSet<T> peek(java.util.function.Consumer<? super T> action)
Valueaction on the first element if this is an eager implementation.
Performs the given action on all elements (the first immediately, successive deferred),
if this is a lazy implementation.SortedSet<T> remove(T element)
SetSortedSet<T> removeAll(java.lang.Iterable<? extends T> elements)
SetSortedSet<T> replace(T currentElement, T newElement)
Traversablereplace in interface Set<T>replace in interface Traversable<T>currentElement - An element to be substituted.newElement - A replacement for currentElement.SortedSet<T> replaceAll(T currentElement, T newElement)
TraversablereplaceAll in interface Set<T>replaceAll in interface Traversable<T>currentElement - An element to be substituted.newElement - A replacement for currentElement.SortedSet<T> retainAll(java.lang.Iterable<? extends T> elements)
TraversableSortedSet<T> scan(T zero, java.util.function.BiFunction<? super T,? super T,? extends T> operation)
Traversablescan in interface Set<T>scan in interface Traversable<T>zero - neutral element for the operator opoperation - the associative operator for the scan<U> Set<U> scanLeft(U zero, java.util.function.BiFunction<? super U,? super T,? extends U> operation)
TraversablescanLeft in interface Set<T>scanLeft in interface Traversable<T>U - the type of the elements in the resulting collectionzero - the initial valueoperation - the binary operator applied to the intermediate result and the element<U> Set<U> scanRight(U zero, java.util.function.BiFunction<? super T,? super U,? extends U> operation)
TraversablescanRight in interface Set<T>scanRight in interface Traversable<T>U - the type of the elements in the resulting collectionzero - the initial valueoperation - the binary operator applied to the intermediate result and the elementIterator<? extends SortedSet<T>> slideBy(java.util.function.Function<? super T,?> classifier)
TraversableTraversable.
Each window contains elements with the same class, as determined by classifier. Two consecutive
values in this Traversable will be in the same window only if classifier returns equal
values for them. Otherwise, the values will constitute the last element of the previous window and the
first element of the next window.
Examples:
[].slideBy(Function.identity()) = []
[1,2,3,4,4,5].slideBy(Function.identity()) = [[1],[2],[3],[4,4],[5]]
[1,2,3,10,12,5,7,20,29].slideBy(x -> x/10) = [[1,2,3],[10,12],[5,7],[20,29]]
Iterator<? extends SortedSet<T>> sliding(int size)
Traversablesize and step size 1 over this Traversable by calling
Traversable.sliding(int, int).Iterator<? extends SortedSet<T>> sliding(int size, int step)
Traversablesize and step size over this Traversable.
Examples:
[].sliding(1,1) = []
[1,2,3,4,5].sliding(2,3) = [[1,2],[4,5]]
[1,2,3,4,5].sliding(2,4) = [[1,2],[5]]
[1,2,3,4,5].sliding(2,5) = [[1,2]]
[1,2,3,4].sliding(5,3) = [[1,2,3,4]]
Tuple2<? extends SortedSet<T>,? extends SortedSet<T>> span(java.util.function.Predicate<? super T> predicate)
Traversablepredicate and the second element is the remainder.SortedSet<T> tail()
TraversableOption<? extends SortedSet<T>> tailOption()
TraversableOption.tailOption in interface Set<T>tailOption in interface Traversable<T>Some(traversable) or None if this is empty.SortedSet<T> take(int n)
Traversable
The result is equivalent to sublist(0, max(0, min(length(), n))) but does not throw if n < 0 or
n > length().
In the case of n < 0 the empty instance is returned, in the case of n > length() this is returned.
SortedSet<T> takeRight(int n)
Traversable
The result is equivalent to sublist(max(0, min(length(), length() - n)), n), i.e. takeRight will not
throw if n < 0 or n > length().
In the case of n < 0 the empty instance is returned, in the case of n > length() this is returned.
SortedSet<T> takeUntil(java.util.function.Predicate<? super T> predicate)
Traversable
Note: This is essentially the same as takeWhile(predicate.negate()). It is intended to be used with
method references, which cannot be negated directly.
SortedSet<T> takeWhile(java.util.function.Predicate<? super T> predicate)
Traversablejava.util.SortedSet<T> toJavaSet()
SetSet to a java.util.Set while preserving characteristics
like insertion order (LinkedHashSet) and sort order (SortedSet).SortedSet<T> union(Set<? extends T> elements)
Setthat set to this set, if not already present.
See also Set.addAll(Iterable).
<U> SortedSet<Tuple2<T,U>> zip(java.lang.Iterable<? extends U> that)
Traversable
The length of the returned traversable is the minimum of the lengths of this traversable and that
iterable.
zip in interface Set<T>zip in interface Traversable<T>U - The type of the second half of the returned pairs.that - The Iterable providing the second half of each result pair.that iterable.<U,R> SortedSet<R> zipWith(java.lang.Iterable<? extends U> that, java.util.function.BiFunction<? super T,? super U,? extends R> mapper)
Traversable
The length of the returned traversable is the minimum of the lengths of this traversable and that
iterable.
zipWith in interface Set<T>zipWith in interface Traversable<T>U - The type of the second parameter of the mapper.R - The type of the mapped elements.that - The Iterable providing the second parameter of the mapper.mapper - a mapper.that iterable.<U> SortedSet<Tuple2<T,U>> zipAll(java.lang.Iterable<? extends U> that, T thisElem, U thatElem)
Traversable
The length of the returned traversable is the maximum of the lengths of this traversable and that
iterable.
Special case: if this traversable is shorter than that elements, and that elements contains duplicates, the resulting traversable may be shorter than the maximum of the lengths of this and that because a traversable contains an element at most once.
If this Traversable is shorter than that, thisElem values are used to fill the result. If that is shorter than this Traversable, thatElem values are used to fill the result.
zipAll in interface Set<T>zipAll in interface Traversable<T>U - The type of the second half of the returned pairs.that - The Iterable providing the second half of each result pair.thisElem - The element to be used to fill up the result if this traversable is shorter than that.thatElem - The element to be used to fill up the result if that is shorter than this traversable.SortedSet<Tuple2<T,java.lang.Integer>> zipWithIndex()
TraversablezipWithIndex in interface Set<T>zipWithIndex in interface Traversable<T><U> SortedSet<U> zipWithIndex(java.util.function.BiFunction<? super T,? super java.lang.Integer,? extends U> mapper)
TraversablezipWithIndex in interface Set<T>zipWithIndex in interface Traversable<T>U - The type of the mapped elements.mapper - a mapper.