Spliterator.OfPrimitive (Java SE 21 & JDK 21)
- Type Parameters:
T- the type of elements returned by this Spliterator. The type must be a wrapper type for a primitive type, such asIntegerfor the primitiveinttype.T_CONS- the type of primitive consumer. The type must be a primitive specialization ofConsumerforT, such asIntConsumerforInteger.T_SPLITR- the type of primitive Spliterator. The type must be a primitive specialization of Spliterator forT, such asSpliterator.OfIntforInteger.
- 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,
A Spliterator specialized for primitive values.
- Since:
- 1.8
- See Also:
-
Nested Class Summary
-
Field Summary
-
Method Summary
default voidPerforms the given action for each remaining element, sequentially in the current thread, until all elements have been processed or the action throws an exception.
booleanIf a remaining element exists, performs the given action on it, returning
true; else returnsfalse.
-
Method Details
-
tryAdvance
boolean tryAdvance
(T_CONS action) If a remaining element exists, performs the given action on it, returning
true; else returnsfalse. If this Spliterator isSpliterator.ORDEREDthe action is performed on the next element in encounter order. Exceptions thrown by the action are relayed to the caller.Subsequent behavior of a spliterator is unspecified if the action throws an exception.
- Parameters:
action- The action- Returns:
falseif no remaining elements existed upon entry to this method, elsetrue.- Throws:
NullPointerException- if the specified action is null
-
forEachRemaining
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. If this Spliterator is
Spliterator.ORDERED, actions are performed in encounter order. Exceptions thrown by the action are relayed to the caller.Subsequent behavior of a spliterator is unspecified if the action throws an exception.
- 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
-