T
- Component typepublic interface Iterator<T> extends Iterator<T>, Traversable<T>
javaslang.collection.Iterator
is a compositional replacement for java.util.Iterator
whose purpose is to iterate once over a sequence of elements.
It is recommended to create instances using AbstractIterator
in favor of Iterator
.
Note: Iterators encapsulate mutable state. They are not meant to be used concurrently by different threads. Do not reuse Iterators, e.g. after passing to List.ofAll(Iterable).
There are two abstract methods: hasNext
for checking if there is a next element available,
and next
which removes the next element from the iterator and returns it. They can be called
an arbitrary amount of times. If hasNext
returns false, a call of next
will throw
a NoSuchElementException
.
Caution: Other methods than hasNext
and next
can be called only once (exclusively).
More specifically, after calling a method it cannot be guaranteed that the next call will succeed.
An Iterator that can be only used once because it is a traversal pointer into a collection, and not a collection
itself.
Modifier and Type | Field and Description |
---|---|
static Iterator<Object> |
EMPTY
The empty Iterator.
|
Modifier and Type | Method and Description |
---|---|
default Iterator<T> |
clear()
Returns an empty version of this traversable, i.e.
|
static <T> Iterator<T> |
concat(Iterable<? extends Iterable<? extends T>> iterables)
Creates an Iterator which traverses along the concatenation of the given iterables.
|
static <T> Iterator<T> |
concat(Iterable<? extends T>... iterables)
Creates an Iterator which traverses along the concatenation of the given iterables.
|
default Iterator<T> |
concat(Iterator<T> that) |
default <U> boolean |
corresponds(Iterable<U> that,
java.util.function.BiPredicate<? super T,? super U> predicate)
Tests whether every element of this iterable relates to the corresponding element of another iterable by
satisfying a test predicate.
|
default Iterator<T> |
distinct()
Returns a new version of this which contains no duplicates.
|
default Iterator<T> |
distinctBy(Comparator<? super T> comparator)
Returns a new version of this which contains no duplicates.
|
default <U> Iterator<T> |
distinctBy(java.util.function.Function<? super T,? extends U> keyExtractor)
Returns a new version of this which contains no duplicates.
|
default Iterator<T> |
drop(int n)
Removes up to n elements from this iterator.
|
default Iterator<T> |
dropRight(int n)
Drops the last n elements of this or all elements, if this length < n.
|
default Iterator<T> |
dropUntil(java.util.function.Predicate<? super T> predicate)
Drops elements until the predicate holds for the current element.
|
default Iterator<T> |
dropWhile(java.util.function.Predicate<? super T> predicate)
Drops elements while the predicate holds for the current element.
|
static <T> Iterator<T> |
empty()
Returns the empty Iterator.
|
default boolean |
eq(Object o)
A smoothing replacement for
equals . |
default boolean |
exists(java.util.function.Predicate<? super T> predicate)
Checks, if an element exists such that the predicate holds.
|
default Iterator<T> |
filter(java.util.function.Predicate<? super T> predicate)
Returns an Iterator that contains elements that satisfy the given
predicate . |
default Option<T> |
findLast(java.util.function.Predicate<? super T> predicate)
Returns the last element of this which satisfies the given predicate.
|
default <U> Iterator<U> |
flatMap(java.util.function.Function<? super T,? extends Iterable<? extends U>> mapper)
FlatMaps the elements of this Iterator to java.lang.Iterables, which are iterated in the order of occurrence.
|
default <U> U |
foldRight(U zero,
java.util.function.BiFunction<? super T,? super U,? extends U> f)
Accumulates the elements of this Traversable by successively calling the given function
f from the right,
starting with a value zero of type B. |
default boolean |
forAll(java.util.function.Predicate<? super T> predicate)
Checks, if the given predicate holds for all elements.
|
default void |
forEach(java.util.function.Consumer<? super T> action)
Performs an action on each element.
|
static Iterator<Integer> |
from(int value)
Returns an infinitely iterator of int values starting from
from . |
static Iterator<Long> |
from(long value)
Returns an infinitely iterator of long values starting from
from . |
static <T> Iterator<T> |
gen(java.util.function.Supplier<? extends T> supplier)
Generates an infinitely iterator using a value Supplier.
|
static <T> Iterator<T> |
gen(T seed,
java.util.function.Function<? super T,? extends T> f)
Generates an infinitely iterator using a function to calculate the next value
based on the previous.
|
default T |
get()
Gets the underlying value or throws if no value is present.
|
default <C> Map<C,Iterator<T>> |
groupBy(java.util.function.Function<? super T,? extends C> classifier)
Groups this elements by classifying the elements.
|
default Iterator<Seq<T>> |
grouped(int size)
Groups this
Traversable into fixed size blocks. |
default boolean |
hasDefiniteSize()
Checks if this Traversable is known to have a finite size.
|
default T |
head()
Returns the first element of a non-empty Traversable.
|
default Option<T> |
headOption()
Returns the first element of a non-empty Traversable as
Option . |
default Iterator<T> |
init()
Dual of Traversable.tail(), returning all elements except the last.
|
default Option<Iterator<T>> |
initOption()
Dual of Traversable.tailOption(), returning all elements except the last as
Option . |
default Iterator<T> |
intersperse(T element)
Inserts an element between all elements of this Iterator.
|
default boolean |
isEmpty()
Checks if this Traversable is empty.
|
default boolean |
isTraversableAgain()
Checks if this Traversable can be repeatedly traversed.
|
default Iterator<T> |
iterator()
An iterator by means of head() and tail().
|
default int |
length()
Computes the number of elements of this.
|
default <U> Iterator<U> |
map(java.util.function.Function<? super T,? extends U> mapper)
Maps the elements of this Iterator lazily using the given
mapper . |
static <T> Iterator<T> |
of(T... elements)
Creates an Iterator which traverses the given elements.
|
static <T> Iterator<T> |
of(T element)
Creates an Iterator which traverses one element.
|
static Iterator<Boolean> |
ofAll(boolean[] array)
Creates an Iterator based on the elements of a boolean array.
|
static Iterator<Byte> |
ofAll(byte[] array)
Creates an Iterator based on the elements of a byte array.
|
static Iterator<Character> |
ofAll(char[] array)
Creates an Iterator based on the elements of a char array.
|
static Iterator<Double> |
ofAll(double[] array)
Creates ann Iterator based on the elements of a double array.
|
static Iterator<Float> |
ofAll(float[] array)
Creates an Iterator based on the elements of a float array.
|
static Iterator<Integer> |
ofAll(int[] array)
Creates an Iterator based on the elements of an int array.
|
static <T> Iterator<T> |
ofAll(Iterable<? extends T> iterable)
Creates an Iterator based on the given java.lang.Iterable.
|
static <T> Iterator<T> |
ofAll(Iterator<? extends T> iterator)
Creates an Iterator based on the given Iterator by
delegating calls of
hasNext() and next() to it. |
static Iterator<Long> |
ofAll(long[] array)
Creates an Iterator based on the elements of a long array.
|
static Iterator<Short> |
ofAll(short[] array)
Creates an Iterator based on the elements of a short array.
|
default Tuple2<Iterator<T>,Iterator<T>> |
partition(java.util.function.Predicate<? super T> predicate)
Creates a partition of this
Traversable by splitting this elements in two in distinct tarversables
according to a predicate. |
default Iterator<T> |
peek(java.util.function.Consumer<? super T> action)
Performs the given
action on the first element if this is an eager implementation. |
static Iterator<Character> |
range(char from,
char toExclusive)
Creates an Iterator of characters starting from
from , extending to toExclusive - 1 . |
static Iterator<Integer> |
range(int from,
int toExclusive)
Creates an Iterator of int numbers starting from
from , extending to toExclusive - 1 . |
static Iterator<Long> |
range(long from,
long toExclusive)
Creates an Iterator of long numbers starting from
from , extending to toExclusive - 1 . |
static Iterator<Character> |
rangeBy(char from,
char toExclusive,
int step)
Creates an Iterator of characters starting from
from , extending to toExclusive - 1 ,
with step . |
static Iterator<Double> |
rangeBy(double from,
double toExclusive,
double step) |
static Iterator<Integer> |
rangeBy(int from,
int toExclusive,
int step)
Creates an Iterator of int numbers starting from
from , extending to toExclusive - 1 ,
with step . |
static Iterator<Long> |
rangeBy(long from,
long toExclusive,
long step)
Creates an Iterator of long numbers starting from
from , extending to toExclusive - 1 ,
with step . |
static Iterator<Character> |
rangeClosed(char from,
char toInclusive)
Creates an Iterator of characters starting from
from , extending to toInclusive . |
static Iterator<Integer> |
rangeClosed(int from,
int toInclusive)
Creates an Iterator of int numbers starting from
from , extending to toInclusive . |
static Iterator<Long> |
rangeClosed(long from,
long toInclusive)
Creates an Iterator of long numbers starting from
from , extending to toInclusive . |
static Iterator<Character> |
rangeClosedBy(char from,
char toInclusive,
int step)
Creates an Iterator of characters starting from
from , extending to toInclusive ,
with step . |
static Iterator<Double> |
rangeClosedBy(double from,
double toInclusive,
double step) |
static Iterator<Integer> |
rangeClosedBy(int from,
int toInclusive,
int step)
Creates an Iterator of int numbers starting from
from , extending to toInclusive ,
with step . |
static Iterator<Long> |
rangeClosedBy(long from,
long toInclusive,
long step)
Creates an Iterator of long numbers starting from
from , extending to toInclusive ,
with step . |
default T |
reduceLeft(java.util.function.BiFunction<? super T,? super T,? extends T> op)
Accumulates the elements of this Traversable by successively calling the given operation
op from the left. |
default T |
reduceRight(java.util.function.BiFunction<? super T,? super T,? extends T> op)
Accumulates the elements of this Traversable by successively calling the given operation
op from the right. |
static <T> Iterator<T> |
repeat(T t)
Repeats an element infinitely often.
|
default Iterator<T> |
replace(T currentElement,
T newElement)
Replaces the first occurrence (if exists) of the given currentElement with newElement.
|
default Iterator<T> |
replaceAll(T currentElement,
T newElement)
Replaces all occurrences of the given currentElement with newElement.
|
default Iterator<T> |
retainAll(Iterable<? extends T> elements)
Keeps all occurrences of the given elements from this.
|
default Traversable<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.
|
default <U> Iterator<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.
|
default <U> Iterator<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.
|
default Iterator<Seq<T>> |
sliding(int size)
Slides a window of a specific
size and step size 1 over this Traversable by calling
Traversable.sliding(int, int) . |
default Iterator<Seq<T>> |
sliding(int size,
int step)
Slides a window of a specific
size and step size over this Traversable . |
default Tuple2<Iterator<T>,Iterator<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. |
default Spliterator<T> |
spliterator() |
default void |
stderr()
Sends the string representations of this value to the standard error stream System.err.
|
default void |
stdout()
Sends the string representations of this value to the standard output stream System.out.
|
default Iterator<T> |
tail()
Drops the first element of a non-empty Traversable.
|
default Option<Iterator<T>> |
tailOption()
Drops the first element of a non-empty Traversable and returns an
Option . |
default Iterator<T> |
take(int n)
Take the first n elements from this iterator.
|
default Iterator<T> |
takeRight(int n)
Takes the last n elements of this or all elements, if this length < n.
|
default Iterator<T> |
takeUntil(java.util.function.Predicate<? super T> predicate)
Takes elements until the predicate holds for the current element.
|
default Iterator<T> |
takeWhile(java.util.function.Predicate<? super T> predicate)
Takes elements while the predicate holds for the current element.
|
default Object[] |
toJavaArray()
Converts this value to an untyped Java array.
|
default <T1,T2> Tuple2<Iterator<T1>,Iterator<T2>> |
unzip(java.util.function.Function<? super T,Tuple2<? extends T1,? extends T2>> unzipper)
Unzips this elements by mapping this elements to pairs which are subsequently split into two distinct
sets.
|
default <T1,T2,T3> Tuple3<Iterator<T1>,Iterator<T2>,Iterator<T3>> |
unzip3(java.util.function.Function<? super T,Tuple3<? extends T1,? extends T2,? extends T3>> unzipper)
Unzips this elements by mapping this elements to triples which are subsequently split into three distinct
sets.
|
default <U> Iterator<Tuple2<T,U>> |
zip(Iterable<U> that)
Returns a traversable formed from this traversable and another java.lang.Iterable collection by combining
corresponding elements in pairs.
|
default <U> Iterator<Tuple2<T,U>> |
zipAll(Iterable<U> that,
T thisElem,
U thatElem)
Returns a traversable formed from this traversable and another java.lang.Iterable by combining corresponding elements in
pairs.
|
default Iterator<Tuple2<T,Integer>> |
zipWithIndex()
Zips this traversable with its indices.
|
forEachRemaining, hasNext, next, remove
average, contains, containsAll, existsUnique, findFirst, foldLeft, hash, isSingletonType, last, lastOption, max, maxBy, maxBy, min, minBy, minBy, mkString, mkString, mkString, product, reduce, sum
equals, get, getOption, hashCode, ifDefined, ifDefined, ifEmpty, ifEmpty, isDefined, orElse, orElseGet, orElseThrow, orElseTry, out, out, toArray, toCharSeq, toJavaArray, toJavaList, toJavaMap, toJavaOptional, toJavaSet, toJavaStream, toLazy, toList, toMap, toOption, toQueue, toSet, toStack, toStream, toString, toTree, toTry, toTry, toVector
@SafeVarargs static <T> Iterator<T> concat(Iterable<? extends T>... iterables)
T
- Component type.iterables
- The iterablesjavaslang.collection.Iterator
static <T> Iterator<T> concat(Iterable<? extends Iterable<? extends T>> iterables)
T
- Component type.iterables
- The iterable of iterablesjavaslang.collection.Iterator
static <T> Iterator<T> empty()
T
- Component typestatic <T> Iterator<T> of(T element)
T
- Component type.element
- An element@SafeVarargs static <T> Iterator<T> of(T... elements)
T
- Component typeelements
- Zero or more elementsstatic <T> Iterator<T> ofAll(Iterable<? extends T> iterable)
Iterator.of(iterable.iterator()
.T
- Component type.iterable
- A Iterable
javaslang.collection.Iterator
static <T> Iterator<T> ofAll(Iterator<? extends T> iterator)
hasNext()
and next()
to it.T
- Component type.iterator
- A Iterator
javaslang.collection.Iterator
static Iterator<Boolean> ofAll(boolean[] array)
array
- a boolean arraystatic Iterator<Byte> ofAll(byte[] array)
array
- a byte arraystatic Iterator<Character> ofAll(char[] array)
array
- a char arraystatic Iterator<Double> ofAll(double[] array)
array
- a double arraystatic Iterator<Float> ofAll(float[] array)
array
- a float arraystatic Iterator<Integer> ofAll(int[] array)
array
- an int arraystatic Iterator<Long> ofAll(long[] array)
array
- a long arraystatic Iterator<Short> ofAll(short[] array)
array
- a short arraystatic Iterator<Character> range(char from, char toExclusive)
from
, extending to toExclusive - 1
.
Examples:
Iterator.range('a', 'c') // = ('a', 'b')
Iterator.range('c', 'a') // = ()
from
- the first charactertoExclusive
- the successor of the last characterfrom >= toExclusive
static Iterator<Character> rangeBy(char from, char toExclusive, int step)
from
, extending to toExclusive - 1
,
with step
.
Examples:
Iterator.rangeBy('a', 'c', 1) // = ('a', 'b')
Iterator.rangeBy('a', 'd', 2) // = ('a', 'c')
Iterator.rangeBy('d', 'a', -2) // = ('d', 'b')
Iterator.rangeBy('d', 'a', 2) // = ()
from
- the first charactertoExclusive
- the successor of the last character if step > 0, the predecessor of the last character if step < 0step
- the step(from == toExclusive) || (step * (from - toExclusive) > 0)
.IllegalArgumentException
- if step
is zerostatic Iterator<Integer> range(int from, int toExclusive)
from
, extending to toExclusive - 1
.
Examples:
Iterator.range(0, 0) // = ()
Iterator.range(2, 0) // = ()
Iterator.range(-2, 2) // = (-2, -1, 0, 1)
from
- the first numbertoExclusive
- the last number + 1from >= toExclusive
static Iterator<Integer> rangeBy(int from, int toExclusive, int step)
from
, extending to toExclusive - 1
,
with step
.
Examples:
Iterator.rangeBy(1, 3, 1) // = (1, 2)
Iterator.rangeBy(1, 4, 2) // = (1, 3)
Iterator.rangeBy(4, 1, -2) // = (4, 2)
Iterator.rangeBy(4, 1, 2) // = ()
from
- the first numbertoExclusive
- the last number + 1 if step > 0, the last number - 1 if step < 0step
- the step(from == toExclusive) || (step * (from - toExclusive) > 0)
.IllegalArgumentException
- if step
is zerostatic Iterator<Long> range(long from, long toExclusive)
from
, extending to toExclusive - 1
.
Examples:
Iterator.range(0L, 0L) // = ()
Iterator.range(2L, 0L) // = ()
Iterator.range(-2L, 2L) // = (-2L, -1L, 0L, 1L)
from
- the first numbertoExclusive
- the last number + 1from >= toExclusive
static Iterator<Long> rangeBy(long from, long toExclusive, long step)
from
, extending to toExclusive - 1
,
with step
.
Examples:
Iterator.rangeBy(1L, 3L, 1L) // = (1L, 2L)
Iterator.rangeBy(1L, 4L, 2L) // = (1L, 3L)
Iterator.rangeBy(4L, 1L, -2L) // = (4L, 2L)
Iterator.rangeBy(4L, 1L, 2L) // = ()
from
- the first numbertoExclusive
- the last number + 1 if step > 0, the last number - 1 if step < 0step
- the step(from == toExclusive) || (step * (from - toExclusive) > 0)
.IllegalArgumentException
- if step
is zerostatic Iterator<Character> rangeClosed(char from, char toInclusive)
from
, extending to toInclusive
.
Examples:
Iterator.rangeClosed('a', 'c') // = ('a', 'b', 'c')
Iterator.rangeClosed('c', 'a') // = ()
from
- the first charactertoInclusive
- the last characterfrom > toInclusive
static Iterator<Character> rangeClosedBy(char from, char toInclusive, int step)
from
, extending to toInclusive
,
with step
.
Examples:
Iterator.rangeClosedBy('a', 'c', 1) // = ('a', 'b', 'c')
Iterator.rangeClosedBy('a', 'd', 2) // = ('a', 'c')
Iterator.rangeClosedBy('d', 'a', -2) // = ('d', 'b')
Iterator.rangeClosedBy('d', 'a', 2) // = ()
from
- the first charactertoInclusive
- the last characterstep
- the stepstep * (from - toInclusive) > 0
.IllegalArgumentException
- if step
is zerostatic Iterator<Integer> rangeClosed(int from, int toInclusive)
from
, extending to toInclusive
.
Examples:
Iterator.rangeClosed(0, 0) // = (0)
Iterator.rangeClosed(2, 0) // = ()
Iterator.rangeClosed(-2, 2) // = (-2, -1, 0, 1, 2)
from
- the first numbertoInclusive
- the last numberfrom > toInclusive
static Iterator<Integer> rangeClosedBy(int from, int toInclusive, int step)
from
, extending to toInclusive
,
with step
.
Examples:
Iterator.rangeClosedBy(1, 3, 1) // = (1, 2, 3)
Iterator.rangeClosedBy(1, 4, 2) // = (1, 3)
Iterator.rangeClosedBy(4, 1, -2) // = (4, 2)
Iterator.rangeClosedBy(4, 1, 2) // = ()
from
- the first numbertoInclusive
- the last numberstep
- the stepstep * (from - toInclusive) > 0
.IllegalArgumentException
- if step
is zerostatic Iterator<Long> rangeClosed(long from, long toInclusive)
from
, extending to toInclusive
.
Examples:
Iterator.rangeClosed(0L, 0L) // = (0L)
Iterator.rangeClosed(2L, 0L) // = ()
Iterator.rangeClosed(-2L, 2L) // = (-2L, -1L, 0L, 1L, 2L)
from
- the first numbertoInclusive
- the last numberfrom > toInclusive
static Iterator<Long> rangeClosedBy(long from, long toInclusive, long step)
from
, extending to toInclusive
,
with step
.
Examples:
Iterator.rangeClosedBy(1L, 3L, 1L) // = (1L, 2L, 3L)
Iterator.rangeClosedBy(1L, 4L, 2L) // = (1L, 3L)
Iterator.rangeClosedBy(4L, 1L, -2L) // = (4L, 2L)
Iterator.rangeClosedBy(4L, 1L, 2L) // = ()
from
- the first numbertoInclusive
- the last numberstep
- the stepstep * (from - toInclusive) > 0
.IllegalArgumentException
- if step
is zerostatic Iterator<Integer> from(int value)
from
.
The Iterator
extends to Integer.MIN_VALUE
when passing Integer.MAX_VALUE
.
value
- a start int valueIterator
of int values starting from from
static Iterator<Long> from(long value)
from
.
The Iterator
extends to Long.MIN_VALUE
when passing Long.MAX_VALUE
.
value
- a start long valueIterator
of long values starting from from
static <T> Iterator<T> gen(java.util.function.Supplier<? extends T> supplier)
T
- value typesupplier
- A Supplier of iterator valuesIterator
static <T> Iterator<T> gen(T seed, java.util.function.Function<? super T,? extends T> f)
T
- value typeseed
- The first value in the iteratorf
- A function to calculate the next value based on the previousIterator
static <T> Iterator<T> repeat(T t)
T
- Element typet
- An elementt
's.default Iterator<T> intersperse(T element)
element
- An element.default <U> Iterator<Tuple2<T,U>> zip(Iterable<U> that)
Traversable
The length of the returned traversable is the minimum of the lengths of this traversable and that
iterable.
zip
in interface Traversable<T>
U
- The type of the second half of the returned pairs.that
- The java.lang.Iterable providing the second half of each result pair.that
iterable.default <U> Iterator<Tuple2<T,U>> zipAll(Iterable<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 Traversable<T>
U
- The type of the second half of the returned pairs.that
- The java.lang.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.default Iterator<Tuple2<T,Integer>> zipWithIndex()
Traversable
zipWithIndex
in interface Traversable<T>
default <T1,T2> Tuple2<Iterator<T1>,Iterator<T2>> unzip(java.util.function.Function<? super T,Tuple2<? extends T1,? extends T2>> unzipper)
Traversable
unzip
in interface Traversable<T>
T1
- 1st element type of a pair returned by unzipperT2
- 2nd element type of a pair returned by unzipperunzipper
- a function which converts elements of this to pairsdefault <T1,T2,T3> Tuple3<Iterator<T1>,Iterator<T2>,Iterator<T3>> unzip3(java.util.function.Function<? super T,Tuple3<? extends T1,? extends T2,? extends T3>> unzipper)
Traversable
unzip3
in interface Traversable<T>
T1
- 1st element type of a triplet returned by unzipperT2
- 2nd element type of a triplet returned by unzipperT3
- 3rd element type of a triplet returned by unzipperunzipper
- a function which converts elements of this to pairsdefault Iterator<T> clear()
Traversable
this.clear().isEmpty() == true
.clear
in interface Traversable<T>
default Iterator<T> distinct()
Traversable
equals
.distinct
in interface Traversable<T>
Traversable
containing this elements without duplicatesdefault Iterator<T> distinctBy(Comparator<? super T> comparator)
Traversable
comparator
.distinctBy
in interface Traversable<T>
comparator
- A comparatorTraversable
containing this elements without duplicatesdefault <U> Iterator<T> distinctBy(java.util.function.Function<? super T,? extends U> keyExtractor)
Traversable
equals
.
The elements of the result are determined in the order of their occurrence - first match wins.
distinctBy
in interface Traversable<T>
U
- key typekeyExtractor
- A key extractorTraversable
containing this elements without duplicatesdefault Iterator<T> drop(int n)
drop
in interface Traversable<T>
n
- A numbern <= 0
or this is empty, otherwise a new iterator without the first n elements.default Iterator<T> dropRight(int n)
Traversable
dropRight
in interface Traversable<T>
n
- The number of elements to drop.default Iterator<T> dropUntil(java.util.function.Predicate<? super T> predicate)
Traversable
Note: This is essentially the same as dropWhile(predicate.negate())
. It is intended to be used with
method references, which cannot be negated directly.
dropUntil
in interface Traversable<T>
predicate
- A condition tested subsequently for this elements.default Iterator<T> dropWhile(java.util.function.Predicate<? super T> predicate)
Traversable
dropWhile
in interface Traversable<T>
predicate
- A condition tested subsequently for this elements starting with the first.default Iterator<T> filter(java.util.function.Predicate<? super T> predicate)
predicate
.default Option<T> findLast(java.util.function.Predicate<? super T> predicate)
Traversable
Same as reverse().findFirst(predicate)
.
findLast
in interface Traversable<T>
predicate
- A predicate.List.of(null).findFirst(e -> e == null)
).default <U> Iterator<U> flatMap(java.util.function.Function<? super T,? extends Iterable<? extends U>> mapper)
default <U> U foldRight(U zero, java.util.function.BiFunction<? super T,? super U,? extends U> f)
Traversable
f
from the right,
starting with a value zero
of type B.
Example: List.of("a", "b", "c").foldRight("", (x, xs) -> x + xs) = "abc"
foldRight
in interface Foldable<T>
foldRight
in interface Traversable<T>
foldRight
in interface Value<T>
U
- Result type of the accumulator.zero
- Value to start the accumulation with.f
- The accumulator function.default T get()
Value
default <C> Map<C,Iterator<T>> groupBy(java.util.function.Function<? super T,? extends C> classifier)
Traversable
groupBy
in interface Traversable<T>
C
- classified class typeclassifier
- A function which classifies elements into classesdefault Iterator<Seq<T>> grouped(int size)
Traversable
Traversable
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)
.grouped
in interface Traversable<T>
size
- a positive block sizedefault boolean hasDefiniteSize()
Traversable
This method should be implemented by classes only, i.e. not by interfaces.
hasDefiniteSize
in interface Traversable<T>
default T head()
Traversable
head
in interface Traversable<T>
default Option<T> headOption()
Traversable
Option
.headOption
in interface Traversable<T>
Some(element)
or None
if this is empty.default Iterator<T> init()
Traversable
init
in interface Traversable<T>
default Option<Iterator<T>> initOption()
Traversable
Option
.initOption
in interface Traversable<T>
Some(traversable)
or None
if this is empty.default boolean isEmpty()
Traversable
default boolean isTraversableAgain()
Traversable
This method should be implemented by classes only, i.e. not by interfaces.
isTraversableAgain
in interface Traversable<T>
default Iterator<T> iterator()
Traversable
default int length()
Traversable
length
in interface Traversable<T>
default <U> Iterator<U> map(java.util.function.Function<? super T,? extends U> mapper)
mapper
.default Tuple2<Iterator<T>,Iterator<T>> partition(java.util.function.Predicate<? super T> predicate)
Traversable
Traversable
by splitting this elements in two in distinct tarversables
according to a predicate.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.default Iterator<T> peek(java.util.function.Consumer<? super T> action)
Value
action
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.default T reduceLeft(java.util.function.BiFunction<? super T,? super T,? extends T> op)
Traversable
op
from the left.reduceLeft
in interface Traversable<T>
op
- A BiFunction of type Tdefault T reduceRight(java.util.function.BiFunction<? super T,? super T,? extends T> op)
Traversable
op
from the right.reduceRight
in interface Traversable<T>
op
- An operation of type Tdefault Iterator<T> replace(T currentElement, T newElement)
Traversable
replace
in interface Traversable<T>
currentElement
- An element to be substituted.newElement
- A replacement for currentElement.default Iterator<T> replaceAll(T currentElement, T newElement)
Traversable
replaceAll
in interface Traversable<T>
currentElement
- An element to be substituted.newElement
- A replacement for currentElement.default Iterator<T> retainAll(Iterable<? extends T> elements)
Traversable
retainAll
in interface Traversable<T>
elements
- Elements to be kept.default Traversable<T> scan(T zero, java.util.function.BiFunction<? super T,? super T,? extends T> operation)
Traversable
scan
in interface Traversable<T>
zero
- neutral element for the operator opoperation
- the associative operator for the scandefault <U> Iterator<U> scanLeft(U zero, java.util.function.BiFunction<? super U,? super T,? extends U> operation)
Traversable
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 elementdefault <U> Iterator<U> scanRight(U zero, java.util.function.BiFunction<? super T,? super U,? extends U> operation)
Traversable
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 elementdefault Iterator<Seq<T>> sliding(int size)
Traversable
size
and step size 1 over this Traversable
by calling
Traversable.sliding(int, int)
.sliding
in interface Traversable<T>
size
- a positive window sizedefault Iterator<Seq<T>> sliding(int size, int step)
Traversable
size
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],[4]]
sliding
in interface Traversable<T>
size
- a positive window sizestep
- a positive step sizedefault Tuple2<Iterator<T>,Iterator<T>> span(java.util.function.Predicate<? super T> predicate)
Traversable
predicate
and the second element is the remainder.span
in interface Traversable<T>
predicate
- A predicate.default Spliterator<T> spliterator()
spliterator
in interface Iterable<T>
default Iterator<T> tail()
Traversable
tail
in interface Traversable<T>
default Option<Iterator<T>> tailOption()
Traversable
Option
.tailOption
in interface Traversable<T>
Some(traversable)
or None
if this is empty.default Iterator<T> take(int n)
take
in interface Traversable<T>
n
- A numbern <= 0
or this is empty, otherwise a new iterator without the first n elements.default Iterator<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.
takeRight
in interface Traversable<T>
n
- The number of elements to take.default Iterator<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.
takeUntil
in interface Traversable<T>
predicate
- A condition tested subsequently for this elements.default Iterator<T> takeWhile(java.util.function.Predicate<? super T> predicate)
Traversable
takeWhile
in interface Traversable<T>
predicate
- A condition tested subsequently for the contained elements.default <U> boolean corresponds(Iterable<U> that, java.util.function.BiPredicate<? super T,? super U> predicate)
U
- Component type of that iterablethat
- the other iterablepredicate
- the test predicate, which relates elements from both iterablestrue
if both iterables have the same length and predicate(x, y)
is true
for all corresponding elements x
of this iterable and y
of that
,
otherwise false
.default boolean eq(Object o)
equals
. It is similar to Scala's ==
but better in the way
that it is not limited to collection types, e.g. Some(1) eq List(1)
, None eq Failure(x)
etc.
In a nutshell: eq checks congruence of structures and equality of contained values.
Example:
// ((1, 2), ((3))) => structure: (()(())) values: 1, 2, 3
final Iterable<?> i1 = List.of(List.of(1, 2), Arrays.asList(List.of(3)));
final Iterable<?> i2 = Queue.of(Stream.of(1, 2), List.of(Lazy.of(() -> 3)));
assertThat(i1.eq(i2)).isTrue();
Semantics:
o == this : true
o instanceof javaslang.Iterable : iterable elements are eq, non-iterable elements equals, for all (o1, o2) in (this, o)
o instanceof java.lang.Iterable : this eq Iterator.of((java.lang.Iterable<?>) o);
otherwise : false
o
- An objectdefault boolean exists(java.util.function.Predicate<? super T> predicate)
predicate
- A PredicateNullPointerException
- if predicate
is nulldefault boolean forAll(java.util.function.Predicate<? super T> predicate)
predicate
- A PredicateNullPointerException
- if predicate
is nulldefault void forEach(java.util.function.Consumer<? super T> action)
forEach
in interface Iterable<T>
action
- A Consumer
NullPointerException
- if action
is nulldefault Object[] toJavaArray()
default void stderr()
IllegalStateException
- if PrintStream.checkError()
is true after writing to stderr.default void stdout()
IllegalStateException
- if PrintStream.checkError()
is true after writing to stdout.Copyright © 2015. All Rights Reserved.