Module java.base
Package java.util
Interface Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>
- Type Parameters:
T
- the type of elements returned by this Spliterator. The type must be a wrapper type for a primitive type, such asInteger
for the primitiveint
type.T_CONS
- the type of primitive consumer. The type must be a primitive specialization ofConsumer
forT
, such asIntConsumer
forInteger
.T_SPLITR
- the type of primitive Spliterator. The type must be a primitive specialization of Spliterator forT
, such asSpliterator.OfInt
forInteger
.
- All Superinterfaces:
Spliterator<T>
- All Known Subinterfaces:
Spliterator.OfDouble
,Spliterator.OfInt
,Spliterator.OfLong
- All Known Implementing Classes:
Spliterators.AbstractDoubleSpliterator
,Spliterators.AbstractIntSpliterator
,Spliterators.AbstractLongSpliterator
- Enclosing interface:
- Spliterator<T>
public static interface Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>> extends Spliterator<T>
A Spliterator specialized for primitive values.
- Since:
- 1.8
- See Also:
Spliterator.OfInt
,Spliterator.OfLong
,Spliterator.OfDouble
-
Nested Class Summary
Nested classes/interfaces declared in interface java.util.Spliterator
Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>
-
Field Summary
Fields declared in interface java.util.Spliterator
CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED
-
Method Summary
Modifier and Type Method 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, returningtrue
; else returnsfalse
.Methods declared in interface java.util.Spliterator
characteristics, estimateSize, forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance, trySplit
-
Method Details
-
tryAdvance
If a remaining element exists, performs the given action on it, returningtrue
; else returnsfalse
. If this Spliterator isSpliterator.ORDERED
the action is performed on the next element in encounter order. Exceptions thrown by the action are relayed to the caller.- Parameters:
action
- The action- Returns:
false
if no remaining elements existed upon entry to this method, elsetrue
.- Throws:
NullPointerException
- if the specified action is null
-
forEachRemaining
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. If this Spliterator isSpliterator.ORDERED
, actions are performed in encounter order. Exceptions thrown by the action are relayed to the caller.- Implementation Requirements:
- The default implementation repeatedly invokes
tryAdvance(T_CONS)
until it returnsfalse
. It should be overridden whenever possible. - Parameters:
action
- The action- Throws:
NullPointerException
- if the specified action is null
-