Class EmptyEnumeration

  extended by net.rim.device.api.util.EmptyEnumeration
All Implemented Interfaces:

public final class EmptyEnumeration
extends Object
implements Enumeration

Permits handling of empty enumerations.

This wrapper around the Enumeration interface handles returning of empty enumerations when no elements exist to be retrieved. This ensures that the invoker does not have to check for null but can rather rely on simply using the enumeration interface.

Constructor Summary
          Constructs a new EmptyEnumeration object.
Method Summary
 boolean hasMoreElements()
          Determines if this enumeration has more objects.
 Object nextElement()
          Retrieves the next element in this enumeration.
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public EmptyEnumeration()
Constructs a new EmptyEnumeration object.

By default, this constructor does nothing.

Method Detail


public boolean hasMoreElements()
Determines if this enumeration has more objects.

Specified by:
hasMoreElements in interface Enumeration
Returns false by default (this is an empty enumeration, so it always returns false).


public Object nextElement()
                   throws NoSuchElementException
Retrieves the next element in this enumeration.

Specified by:
nextElement in interface Enumeration
Nothing by default (this is an empty enumeration, so there's no next object to return).
NoSuchElementException - Always by default, since this is an empty enumeration.

Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.