public class EmptyIterator extends java.lang.Object implements SequenceIterator, ReversibleIterator, LastPositionFinder, GroundedIterator, LookaheadIterator, UnfailingIterator, AtomizedValueIterator
Modifier and Type | Class and Description |
---|---|
static class |
EmptyIterator.OfAtomic
An empty iterator for use where a sequence of atomic values is required
|
static class |
EmptyIterator.OfNodes
An empty iterator for use where a sequence of nodes is required
|
ATOMIZING, GROUNDED, LAST_POSITION_FINDER, LOOKAHEAD
Modifier | Constructor and Description |
---|---|
protected |
EmptyIterator()
Protected constructor
|
Modifier and Type | Method and Description |
---|---|
void |
close()
Close the iterator.
|
static EmptyIterator |
emptyIterator() |
static EmptyIterator |
getInstance()
Get an EmptyIterator, an iterator over an empty sequence.
|
int |
getLength()
Get the position of the last item in the sequence.
|
int |
getProperties()
Get properties of this iterator, as a bit-significant integer.
|
GroundedValue |
getResidue()
Return a GroundedValue containing all the remaining items in the sequence returned by this
SequenceIterator, starting at the current position.
|
EmptyIterator |
getReverseIterator()
Get another iterator over the same items, in reverse order.
|
boolean |
hasNext()
Determine whether there are more items to come.
|
GroundedValue |
materialize()
Return a Value containing all the items in the sequence returned by this
SequenceIterator.
|
Item |
next()
Get the next item.
|
AtomicSequence |
nextAtomizedValue()
Deliver the atomic value that is next in the atomized result
|
public static EmptyIterator getInstance()
public static EmptyIterator emptyIterator()
public AtomicSequence nextAtomizedValue() throws XPathException
nextAtomizedValue
in interface AtomizedValueIterator
XPathException
- if a failure occurs reading or atomizing the next valuepublic Item next()
next
in interface SequenceIterator
next
in interface UnfailingIterator
public int getLength()
getLength
in interface LastPositionFinder
public void close()
SequenceIterator
(Currently, closing an iterator is important only when the data is being "pushed" in another thread. Closing the iterator terminates that thread and means that it needs to do no additional work. Indeed, failing to close the iterator may cause the push thread to hang waiting for the buffer to be emptied.)
close
in interface SequenceIterator
public EmptyIterator getReverseIterator()
getReverseIterator
in interface ReversibleIterator
public int getProperties()
getProperties
in interface SequenceIterator
SequenceIterator.GROUNDED
, SequenceIterator.LAST_POSITION_FINDER
,
and SequenceIterator.LOOKAHEAD
. It is always
acceptable to return the value zero, indicating that there are no known special properties.
It is acceptable for the properties of the iterator to change depending on its state.public GroundedValue materialize()
materialize
in interface GroundedIterator
public GroundedValue getResidue() throws XPathException
GroundedIterator
getResidue
in interface GroundedIterator
XPathException
- in the cases of subclasses (such as the iterator over a MemoClosure)
which cause evaluation of expressions while materializing the value.public boolean hasNext()
hasNext
in interface LookaheadIterator
Copyright (c) 2004-2018 Saxonica Limited. All rights reserved.