T
- the type of elements returned by this Spliterator. The
type must be a wrapper type for a primitive type, such as Integer
for the primitive int
type.T_CONS
- the type of primitive consumer. The type must be a
primitive specialization of Consumer
for
T
, such as IntConsumer
for
Integer
.T_SPLITR
- the type of primitive Spliterator. The type must be
a primitive specialization of Spliterator for T
, such as
Spliterator.OfInt
for Integer
.public static interface Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>> extends Spliterator<T>
Spliterator.OfInt
,
Spliterator.OfLong
,
Spliterator.OfDouble
Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>
CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED
Modifier and Type | Method and Description |
---|---|
default void |
forEachRemaining(T_CONS action)
Performs the given action for each remaining element, sequentially in
the current thread, until all elements have been processed or the
action throws an exception.
|
boolean |
tryAdvance(T_CONS action)
If a remaining element exists, performs the given action on it,
returning
true ; else returns false . |
T_SPLITR |
trySplit()
If this spliterator can be partitioned, returns a Spliterator
covering elements, that will, upon return from this method, not
be covered by this Spliterator.
|
characteristics, estimateSize, forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance
T_SPLITR trySplit()
Spliterator
If this Spliterator is Spliterator.ORDERED
, the returned Spliterator
must cover a strict prefix of the elements.
Unless this Spliterator covers an infinite number of elements,
repeated calls to trySplit()
must eventually return null
.
Upon non-null return:
estimateSize()
before splitting,
must, after splitting, be greater than or equal to estimateSize()
for this and the returned Spliterator; andSUBSIZED
, then estimateSize()
for this spliterator before splitting must be equal to the sum of
estimateSize()
for this and the returned Spliterator after
splitting.This method may return null
for any reason,
including emptiness, inability to split after traversal has
commenced, data structure constraints, and efficiency
considerations.
trySplit
in interface Spliterator<T>
Spliterator
covering some portion of the
elements, or null
if this spliterator cannot be splitboolean tryAdvance(T_CONS action)
true
; else returns false
. If this
Spliterator is Spliterator.ORDERED
the action is performed on the
next element in encounter order. Exceptions thrown by the
action are relayed to the caller.action
- The actionfalse
if no remaining elements existed
upon entry to this method, else true
.NullPointerException
- if the specified action is nulldefault void forEachRemaining(T_CONS action)
Spliterator.ORDERED
,
actions are performed in encounter order. Exceptions thrown by the
action are relayed to the caller.tryAdvance(T_CONS)
until it returns false
. It should be overridden whenever
possible.action
- The actionNullPointerException
- if the specified action is null Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2019, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.