Interface CharIterator

All Superinterfaces:
java.util.Iterator<java.lang.Character>, java.util.PrimitiveIterator<java.lang.Character,​CharConsumer>
All Known Subinterfaces:
CharBidirectionalIterator, CharBigListIterator, CharListIterator
All Known Implementing Classes:
AbstractCharBidirectionalIterator, AbstractCharBigListIterator, AbstractCharIterator, AbstractCharListIterator, CharBigListIterators.AbstractIndexBasedBigIterator, CharBigListIterators.AbstractIndexBasedBigListIterator, CharBigListIterators.BigListIteratorListIterator, CharBigListIterators.EmptyBigListIterator, CharBigListIterators.UnmodifiableBigListIterator, CharIterators.AbstractIndexBasedIterator, CharIterators.AbstractIndexBasedListIterator, CharIterators.EmptyIterator, CharIterators.UnmodifiableBidirectionalIterator, CharIterators.UnmodifiableIterator, CharIterators.UnmodifiableListIterator

public interface CharIterator
extends java.util.PrimitiveIterator<java.lang.Character,​CharConsumer>
A type-specific Iterator; provides an additional method to avoid (un)boxing, and the possibility to skip elements.
See Also:
Iterator
  • Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.PrimitiveIterator

    java.util.PrimitiveIterator.OfDouble, java.util.PrimitiveIterator.OfInt, java.util.PrimitiveIterator.OfLong
  • Method Summary

    Modifier and Type Method 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 method instead.
    default void forEachRemaining​(java.util.function.IntConsumer action)
    Performs the given action for each remaining element, performing widening primitive casts, until all elements have been processed or the action throws an exception.
    default java.lang.Character next()
    Deprecated.
    Please use the corresponding type-specific method instead.
    char nextChar()
    Returns the next element as a primitive type.
    default int skip​(int n)
    Skips the given number of elements.

    Methods inherited from interface java.util.Iterator

    hasNext, remove
  • Method Details

    • nextChar

      char nextChar()
      Returns the next element as a primitive type.
      Returns:
      the next element in the iteration.
      See Also:
      Iterator.next()
    • next

      @Deprecated default java.lang.Character next()
      Deprecated.
      Please use the corresponding type-specific method instead.
      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.
      Specified by:
      forEachRemaining in interface java.util.PrimitiveIterator<java.lang.Character,​CharConsumer>
      Parameters:
      action - the action to be performed for each element.
      Since:
      8.0.0
      See Also:
      Iterator.forEachRemaining(java.util.function.Consumer)
      API Notes:
      Implementing classes should generally override this method, and take the default implementation of the other overloads which will delegate to this method (after proper conversions).
    • forEachRemaining

      default void forEachRemaining​(java.util.function.IntConsumer action)
      Performs the given action for each remaining element, performing widening primitive casts, until all elements have been processed or the action throws an exception.
      Parameters:
      action - the action to be performed for each element.
      Since:
      8.5.0
      See Also:
      Iterator.forEachRemaining(java.util.function.Consumer)
      Implementation Notes:
      Unless the argument is type-specific, this method will introduce an intermediary lambda to perform widening casts. Please use the type-specific overload to avoid this overhead.
    • forEachRemaining

      @Deprecated default void forEachRemaining​(java.util.function.Consumer<? super java.lang.Character> action)
      Deprecated.
      Please use the corresponding type-specific method instead.
      Specified by:
      forEachRemaining in interface java.util.Iterator<java.lang.Character>
    • skip

      default int skip​(int n)
      Skips the given number of elements.

      The effect of this call is exactly the same as that of calling next() for n times (possibly stopping if Iterator.hasNext() becomes false).

      Parameters:
      n - the number of elements to skip.
      Returns:
      the number of elements actually skipped.
      See Also:
      Iterator.next()