java8.util

Class Iterators

java.lang.Object

java8.util.Iterators

public final class Iterators
extends Object

A place for static default implementations of the new Java 8 default interface methods and static interface methods in the Iterator interface.

Method Summary

Modifier and Type	Method and Description
static <E> void	forEachRemaining(Iterator<E> it, Consumer<? super E> action) Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
static void	forEachRemaining(PrimitiveIterator.OfDouble it, DoubleConsumer action) Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
static void	forEachRemaining(PrimitiveIterator.OfInt it, IntConsumer action) Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
static void	forEachRemaining(PrimitiveIterator.OfLong it, LongConsumer action) Performs the given action for each remaining element until all elements have been processed or the action throws an exception.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

forEachRemaining

public static <E> void forEachRemaining(Iterator<E> it,
                                        Consumer<? super E> action)

Performs the given action for each remaining element until all elements have been processed or the action throws an exception. Actions are performed in the order of iteration. Exceptions thrown by the action are relayed to the caller.

The implementation behaves as if:

     while (it.hasNext())
       action.accept(it.next());
 

Type Parameters:

E - the type of the elements for the passed iterator

Parameters:

it - the Iterator whose remaining elements should be processed

action - The action to be performed for each element

Throws:

NullPointerException - if the specified iterator is null

NullPointerException - if the specified action is null

Since:

1.8

forEachRemaining

public static void forEachRemaining(PrimitiveIterator.OfInt it,
                                    IntConsumer action)

Performs the given action for each remaining element until all elements have been processed or the action throws an exception. Actions are performed in the order of iteration. Exceptions thrown by the action are relayed to the caller.

The implementation behaves as if:

     while (it.hasNext())
       action.accept(it.next());
 

Parameters:

it - the Iterator whose remaining elements should be processed

action - The action to be performed for each element

Throws:

NullPointerException - if the specified iterator is null

NullPointerException - if the specified action is null

Since:

1.8

forEachRemaining

public static void forEachRemaining(PrimitiveIterator.OfLong it,
                                    LongConsumer action)

Performs the given action for each remaining element until all elements have been processed or the action throws an exception. Actions are performed in the order of iteration. Exceptions thrown by the action are relayed to the caller.

The implementation behaves as if:

     while (it.hasNext())
       action.accept(it.next());
 

Parameters:

it - the Iterator whose remaining elements should be processed

action - The action to be performed for each element

Throws:

NullPointerException - if the specified iterator is null

NullPointerException - if the specified action is null

Since:

1.8

forEachRemaining

public static void forEachRemaining(PrimitiveIterator.OfDouble it,
                                    DoubleConsumer action)

Performs the given action for each remaining element until all elements have been processed or the action throws an exception. Actions are performed in the order of iteration. Exceptions thrown by the action are relayed to the caller.

The implementation behaves as if:

     while (it.hasNext())
       action.accept(it.next());
 

Parameters:

it - the Iterator whose remaining elements should be processed

action - The action to be performed for each element

Throws:

NullPointerException - if the specified iterator is null

NullPointerException - if the specified action is null

Since:

1.8