## 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

Copyright (c) 2004-2010 Saxonica Limited. All rights reserved.