com.partnersoft.data

Class EmptyIterator<T>

java.lang.Object

com.partnersoft.data.EmptyIterator<T>

All Implemented Interfaces:

java.util.Iterator<T>

public class EmptyIterator<T>
extends java.lang.Object
implements java.util.Iterator<T>

An Iterator for nothing.

Use EmptyIterator whenever you want a non-null, but empty, Iterator. It has no state so feel free to use the standardInstance() and avoid creating a new copy.

Copyright 2003-2006 Partner Software, Inc.

Author:

Paul Reavis

Constructor Summary

Constructors

Constructor and Description
EmptyIterator() Creates an EmptyIterator.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	hasNext() Always returns false.
T	next() Always throws NoSuchElementException.
void	remove() Always throws UnsupportedOperationException.
static EmptyIterator	standardInstance()

Methods inherited from class java.lang.Object

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

Constructor Detail

EmptyIterator

public EmptyIterator()

Creates an EmptyIterator. All EmptyIterators are equivalent and stateless, so consider using standardInstance() instead.

Method Detail

standardInstance

public static EmptyIterator standardInstance()

hasNext

public boolean hasNext()

Always returns false.

Specified by:

hasNext in interface java.util.Iterator<T>

next

public T next()

Always throws NoSuchElementException.

Specified by:

next in interface java.util.Iterator<T>

remove

public void remove()

Always throws UnsupportedOperationException.

Specified by:

remove in interface java.util.Iterator<T>