speiger.src.collections.chars.collections

Interface CharIterator

All Superinterfaces:

java.util.Iterator<java.lang.Character>

All Known Subinterfaces:

CharBidirectionalIterator, CharListIterator, CharSplititerator

public interface CharIterator
extends java.util.Iterator<java.lang.Character>

A Type-Specific Iterator that reduces (un)boxing

Method Summary

Modifier and Type	Method and Description
default void	forEachRemaining(CharConsumer action) Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
default void	forEachRemaining(java.util.function.Consumer<? super java.lang.Character> action) Deprecated. Please use the corresponding type-specific function instead.
default java.lang.Character	next() Deprecated. Please use the corresponding type-specific function instead.
char	nextChar() Returns the next element in the iteration.
default int	skip(int amount) Skips the Given amount of elements if possible.

Methods inherited from interface java.util.Iterator

hasNext, remove

Method Detail

nextChar

char nextChar()

Returns the next element in the iteration.

Returns:

the next element in the iteration

Throws:

java.util.NoSuchElementException - if the iteration has no more elements

See Also:

Iterator.next()

next

@Deprecated
default java.lang.Character next()

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

next in interface java.util.Iterator<java.lang.Character>

forEachRemaining

default void forEachRemaining(CharConsumer 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, if that order is specified. Exceptions thrown by the action are relayed to the caller.

Parameters:

action - The action to be performed for each element

Throws:

java.lang.NullPointerException - if the specified action is null

See Also:

Iterator.forEachRemaining(Consumer)

ImplSpec:

The default implementation behaves as if:

     while (hasNext()) action.accept(nextChar());
 

forEachRemaining

@Deprecated
default void forEachRemaining(java.util.function.Consumer<? super java.lang.Character> action)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

forEachRemaining in interface java.util.Iterator<java.lang.Character>

skip

default int skip(int amount)

Skips the Given amount of elements if possible. A Optimization function to skip elements faster if the implementation allows it.

Parameters:

amount - the amount of elements that should be skipped

Returns:

the amount of elements that were skipped