net.sf.saxon.s9api
Class XdmSequenceIterator

java.lang.Object
  extended by net.sf.saxon.s9api.XdmSequenceIterator
All Implemented Interfaces:
Iterator<XdmItem>

public class XdmSequenceIterator
extends Object
implements Iterator<XdmItem>

An iterator over an XPath sequence.

This class implements the standard Java Iterator interface.

Because the Iterator interface does not define any checked exceptions, the hasNext() method of this iterator throws an unchecked exception if a dynamic error occurs while evaluating the expression. Applications wishing to control error handling should take care to catch this exception.


Method Summary
 boolean hasNext()
          Returns true if the iteration has more elements.
 XdmItem next()
          Returns the next element in the iteration.
 void remove()
          Not supported on this implementation.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

hasNext

public boolean hasNext()
                throws SaxonApiUncheckedException
Returns true if the iteration has more elements. (In other words, returns true if next would return an element rather than throwing an exception.)

Specified by:
hasNext in interface Iterator<XdmItem>
Returns:
true if the iterator has more elements.
Throws:
SaxonApiUncheckedException - if a dynamic error occurs during XPath evaluation that is detected at this point.

next

public XdmItem next()
Returns the next element in the iteration. Calling this method repeatedly until the hasNext() method returns false will return each element in the underlying collection exactly once.

Specified by:
next in interface Iterator<XdmItem>
Returns:
the next element in the iteration.
Throws:
NoSuchElementException - iteration has no more elements.

remove

public void remove()
Not supported on this implementation.

Specified by:
remove in interface Iterator<XdmItem>
Throws:
UnsupportedOperationException - always


Copyright (C) Michael H. Kay. All rights reserved.