net.sf.saxon.tree.iter
Class ReverseNodeArrayIterator

java.lang.Object
  net.sf.saxon.tree.iter.ReverseArrayIterator
      net.sf.saxon.tree.iter.ReverseNodeArrayIterator

All Implemented Interfaces:

LastPositionFinder, SequenceIterator, AxisIterator, LookaheadIterator, ReversibleIterator, 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.tree.iter.ReverseArrayIterator

close, current, getLastPosition, getProperties, hasNext, next, position

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.saxon.tree.iter.UnfailingIterator

current, next, position

Methods inherited from interface net.sf.saxon.om.SequenceIterator

close, 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