org.apache.commons.collections4.iterators

## Class SingletonIterator<E>

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

- All Implemented Interfaces:
    Iterator<E>, ResettableIterator<E>

      public class SingletonIterator<E>
      extends Object
      implements ResettableIterator<E>

  `SingletonIterator` is an `Iterator` over a single object instance.
  Since:
    2.0
  Version:
    $Id: SingletonIterator.java 1612021 2014-07-20 04:51:05Z ggregory $

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `SingletonIterator(E object)` Constructs a new `SingletonIterator` where `remove` is a permitted operation.
    `SingletonIterator(E object, boolean removeAllowed)` Constructs a new `SingletonIterator` optionally choosing if `remove` is a permitted operation.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `boolean` | `hasNext()` Is another object available from the iterator?
    `E` | `next()` Get the next object from the iterator.
    `void` | `remove()` Remove the object from this iterator.
    `void` | `reset()` Reset the iterator to the start.

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

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

- - ### Constructor Detail

    - #### SingletonIterator

          public SingletonIterator(E object)

      Constructs a new `SingletonIterator` where `remove` is a permitted operation.
      Parameters:
        `object` - the single object to return from the iterator

    - #### SingletonIterator

          public SingletonIterator(E object,
                           boolean removeAllowed)

      Constructs a new `SingletonIterator` optionally choosing if `remove` is a permitted operation.
      Parameters:
        `object` - the single object to return from the iterator
        `removeAllowed` - true if remove is allowed
      Since:
        3.1

  - ### Method Detail

    - #### hasNext

          public boolean hasNext()

      Is another object available from the iterator?

      This returns true if the single object hasn't been returned yet.

      Specified by:
        `hasNext` in interface `Iterator<E>`
      Returns:
        true if the single object hasn't been returned yet

    - #### next

          public E next()

      Get the next object from the iterator.

      This returns the single object if it hasn't been returned yet.

      Specified by:
        `next` in interface `Iterator<E>`
      Returns:
        the single object
      Throws:
        `NoSuchElementException` - if the single object has already been returned

    - #### remove

          public void remove()

      Remove the object from this iterator.
      Specified by:
        `remove` in interface `Iterator<E>`
      Throws:
        `IllegalStateException` - if the `next` method has not yet been called, or the `remove` method has already been called after the last call to the `next` method.
        `UnsupportedOperationException` - if remove is not supported

    - #### reset

          public void reset()

      Reset the iterator to the start.
      Specified by:
        `reset` in interface `ResettableIterator<E>`

Copyright © 2001–2015 The Apache Software Foundation. All rights reserved.