Package org.apache.commons.collections4.iterators

# Class UnmodifiableIterator<E>

java.lang.Object
org.apache.commons.collections4.iterators.UnmodifiableIterator<E>

Type Parameters:
  `E` - the type of elements returned by this iterator.

All Implemented Interfaces:
  `Iterator<E>`, `Unmodifiable`

public final class UnmodifiableIterator<E> extends Object implements Iterator<E>, Unmodifiable
Decorates an iterator such that it cannot be modified.

Attempts to modify it will result in an UnsupportedOperationException.

Since:
  3.0

- ## Method Summary

  Modifier and Type
  Method
  Description
  `boolean`
  `hasNext()`
  `E`
  `next()`
  `void`
  `remove()`
  `static <E> Iterator<E>`
  `unmodifiableIterator(Iterator<? extends E> iterator)`
  Decorates the specified iterator such that it cannot be modified.

  ### Methods inherited from class java.lang.Object

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

  ### Methods inherited from interface java.util.Iterator

  `forEachRemaining`

- ## Method Details

  - ### unmodifiableIterator

    public static <E> Iterator<E> unmodifiableIterator(Iterator<? extends E> iterator)
    Decorates the specified iterator such that it cannot be modified.

    If the iterator is already unmodifiable it is returned directly.

    Type Parameters:
      `E` - the element type
    Parameters:
      `iterator` - the iterator to decorate
    Returns:
      a new unmodifiable iterator
    Throws:
      `NullPointerException` - if the iterator is null

  - ### hasNext

    public boolean hasNext()
    Specified by:
      `hasNext` in interface `Iterator<E>`

  - ### next

    public E next()
    Specified by:
      `next` in interface `Iterator<E>`

  - ### remove

    public void remove()
    Specified by:
      `remove` in interface `Iterator<E>`