org.apache.commons.collections.iterators
Class SingletonIterator<E>

java.lang.Object
  extended by org.apache.commons.collections.iterators.SingletonIterator<E>
All Implemented Interfaces:
Iterator<E>, ResettableIterator<E>

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

SingletonIterator is an Iterator over a single object instance.

Since:
Commons Collections 2.0
Version:
$Revision: 1.1.1.1 $ $Date: 2005/05/23 04:35:01 $
Author:
James Strachan, Stephen Colebourne, Matt Hall, John Watkinson, Rodney Waldhoff

Constructor Summary
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
 boolean hasNext()
          Is another object available from the iterator?

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

 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:
Commons Collections 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 © 2005-2005 Apache Software Foundation, Matt Hall, John Watkinson. All Rights Reserved.