home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1997 May / Pcwk0597.iso / sybase / starbuck / java.z / Enumeration.java < prev    next >
Text File  |  1996-05-03  |  2KB  |  52 lines
  1. /*
  2.  * @(#)Enumeration.java    1.9 95/08/13  
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package java.util;
  21.  
  22. /**
  23.  * The Enumeration interface specifies a set of methods that may be used
  24.  * to enumerate, or count through, a set of values. The enumeration is
  25.  * consumed by use; its values may only be counted once.<p>
  26.  *
  27.  * For example, to print all elements of a Vector v:
  28.  * <pre>
  29.  *    for (Enumeration e = v.elements() ; e.hasMoreElements() ;) {
  30.  *        System.out.println(e.nextElement());
  31.  *    }
  32.  * </pre>
  33.  * @see Vector
  34.  * @see Hashtable
  35.  * @version     1.9, 13 Aug 1995
  36.  * @author    Lee Boynton
  37.  */
  38. public interface Enumeration {
  39.     /**
  40.      * Returns true if the enumeration contains more elements; false
  41.      * if its empty.
  42.      */
  43.     boolean hasMoreElements();
  44.  
  45.     /**
  46.      * Returns the next element of the enumeration. Calls to this
  47.      * method will enumerate successive elements.
  48.      * @exception NoSuchElementException If no more elements exist.
  49.      */
  50.     Object nextElement();
  51. }
  52.