T - the type of elements returned by this PrimitiveIterator. 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.Iterator<T>public interface PrimitiveIterator<T,T_CONS> extends Iterator<T>
Iterator. Specialized
subtypes are provided for OfInt, OfLong, and
OfDouble values.
The specialized subtype default implementations of Iterator#next
and Iterator#forEachRemaining(java.util.function.Consumer) box
primitive values to instances of their corresponding wrapper class. Such
boxing may offset any advantages gained when using the primitive
specializations. To avoid boxing, the corresponding primitive-based methods
should be used. For example, PrimitiveIterator.OfInt#nextInt() and
PrimitiveIterator.OfInt#forEachRemaining(java.util.function.IntConsumer)
should be used in preference to PrimitiveIterator.OfInt#next() and
PrimitiveIterator.OfInt#forEachRemaining(java.util.function.Consumer).
Iteration of primitive values using boxing-based methods
Iterator#next and
Iterator#forEachRemaining(java.util.function.Consumer),
does not affect the order in which the values, transformed to boxed values,
are encountered.
| 限定符和类型 | 接口 | 说明 |
|---|---|---|
static interface |
PrimitiveIterator.OfDouble |
An Iterator specialized for
double values. |
static interface |
PrimitiveIterator.OfInt |
An Iterator specialized for
int values. |
static interface |
PrimitiveIterator.OfLong |
An Iterator specialized for
long values. |
| 限定符和类型 | 方法 | 说明 |
|---|---|---|
void |
forEachRemaining(T_CONS action) |
Performs the given action for each remaining element, in the order
elements occur when iterating, until all elements have been processed
or the action throws an exception.
|
forEachRemaining, hasNext, next, removevoid forEachRemaining(T_CONS action)
action - The action to be performed for each elementNullPointerException - if the specified action is null