net.sf.saxon.om
Class ReverseNodeArrayIterator

java.lang.Object
  extended by net.sf.saxon.om.ReverseArrayIterator
      extended by net.sf.saxon.om.ReverseNodeArrayIterator
All Implemented Interfaces:
LastPositionFinder, ReversibleIterator, AxisIterator, LookaheadIterator, SequenceIterator, UnfailingIterator

public class ReverseNodeArrayIterator
extends ReverseArrayIterator
implements AxisIterator

Iterator over an array of nodes in reverse order


Field Summary
 
Fields inherited from interface net.sf.saxon.om.SequenceIterator
GROUNDED, LAST_POSITION_FINDER, LOOKAHEAD
 
Constructor Summary
ReverseNodeArrayIterator(Item[] items, int start, int end)
          Create a reverse iterator over a slice of an array
 
Method Summary
 Value atomize()
          Return the atomized value of the current node.
 SequenceIterator getAnother()
          Get another iterator over the same items
 SequenceIterator getReverseIterator()
          Get an iterator that processes the same items in reverse order.
 CharSequence getStringValue()
          Return the string value of the current node.
 AxisIterator iterateAxis(byte axis, NodeTest test)
          Return an iterator over an axis, starting at the current node.
 boolean moveNext()
          Move to the next node, without returning it.
 
Methods inherited from class net.sf.saxon.om.ReverseArrayIterator
current, getLastPosition, getProperties, hasNext, next, position
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface net.sf.saxon.om.UnfailingIterator
current, next, position
 
Methods inherited from interface net.sf.saxon.om.SequenceIterator
getProperties
 

Constructor Detail

ReverseNodeArrayIterator

public ReverseNodeArrayIterator(Item[] items,
                                int start,
                                int end)
Create a reverse iterator over a slice of an array

Parameters:
items - The array of items
start - The first item in the array to be be used (this will be the last one in the resulting iteration). Zero-based.
end - The item after the last one in the array to be used (this will be the first one to be returned by the iterator). Zero-based.
Method Detail

moveNext

public boolean moveNext()
Move to the next node, without returning it. Returns true if there is a next node, false if the end of the sequence has been reached. After calling this method, the current node may be retrieved using the current() function.

Specified by:
moveNext in interface AxisIterator

iterateAxis

public AxisIterator iterateAxis(byte axis,
                                NodeTest test)
Return an iterator over an axis, starting at the current node.

Specified by:
iterateAxis in interface AxisIterator
Parameters:
axis - the axis to iterate over, using a constant such as Axis.CHILD
test - a predicate to apply to the nodes before returning them.
Throws:
NullPointerException - if there is no current node

atomize

public Value atomize()
              throws XPathException
Return the atomized value of the current node.

Specified by:
atomize in interface AxisIterator
Returns:
the atomized value.
Throws:
NullPointerException - if there is no current node
XPathException

getStringValue

public CharSequence getStringValue()
Return the string value of the current node.

Specified by:
getStringValue in interface AxisIterator
Returns:
the string value, as an instance of CharSequence.
Throws:
NullPointerException - if there is no current node

getAnother

public SequenceIterator getAnother()
Get another iterator over the same items

Specified by:
getAnother in interface SequenceIterator
Specified by:
getAnother in interface UnfailingIterator
Overrides:
getAnother in class ReverseArrayIterator
Returns:
another iterator over the same items, positioned at the start of the sequence

getReverseIterator

public SequenceIterator getReverseIterator()
Get an iterator that processes the same items in reverse order. Since this iterator is processing the items backwards, this method returns an ArrayIterator that processes them forwards.

Specified by:
getReverseIterator in interface ReversibleIterator
Overrides:
getReverseIterator in class ReverseArrayIterator
Returns:
a new ArrayIterator


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