1  // HTMLParser Library $Name: v1_6_20060319 $ - A java-based parser for HTML
 2  // http://sourceforge.org/projects/htmlparser
 3  // Copyright (C) 2004 Somik Raha
 4  //
 5  // Revision Control Information
 6  //
 7  // $Source: /cvsroot/htmlparser/htmlparser/src/org/htmlparser/util/SimpleNodeIterator.java,v $
 8  // $Author: derrickoswald $
 9  // $Date: 2004/01/02 16:24:58 $
10  // $Revision: 1.34 $
11  //
12  // This library is free software; you can redistribute it and/or
13  // modify it under the terms of the GNU Lesser General Public
14  // License as published by the Free Software Foundation; either
15  // version 2.1 of the License, or (at your option) any later version.
16  //
17  // This library is distributed in the hope that it will be useful,
18  // but WITHOUT ANY WARRANTY; without even the implied warranty of
19  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20  // Lesser General Public License for more details.
21  //
22  // You should have received a copy of the GNU Lesser General Public
23  // License along with this library; if not, write to the Free Software
24  // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25  //
26  
27  package org.htmlparser.util;
28  
29  import org.htmlparser.Node;
30  
31  /**
32   * The HTMLSimpleEnumeration interface is similar to NodeIterator,
33   * except that it does not throw exceptions. This interface is useful
34   * when using HTMLVector, to enumerate through its elements in a simple
35   * manner, without needing to do class casts for Node.
36   * @author Somik Raha
37   */
38  public interface SimpleNodeIterator extends NodeIterator
39  {
40      /**
41       * Check if more nodes are available.
42       * @return <code>true</code> if a call to <code>nextHTMLNode()</code> will
43       * succeed.
44       */
45      public boolean hasMoreNodes();
46  
47      /**
48       * Get the next node.
49       * @return The next node in the HTML stream, or null if there are no more
50       * nodes.
51       */
52      public Node nextNode();
53  }