Package net.sf.saxon.om

Class ArrayIterator

    • Field Detail

      • items

        protected Item[] items

      • start

        protected int start

      • end

        protected int end

    • Constructor Detail

      • ArrayIterator

        public ArrayIterator​(Item[] nodes)
        Create an iterator over all the items in an array
        Parameters:
        nodes - the array (of any items, not necessarily nodes) to be processed by the iterator

      • ArrayIterator

        public ArrayIterator​(Item[] items,
                     int start,
                     int end)
        Create an iterator over a range of an array. Note that the start position is zero-based
        Parameters:
        items - the array (of nodes or simple values) to be processed by the iterator
        start - the position of the first item to be processed (numbering from zero). Must be between zero and nodes.length-1; if not, undefined exceptions are likely to occur.
        end - position of first item that is NOT returned, zero-based. Must be beween 1 and nodes.length; if not, undefined exceptions are likely to occur.

    • Method Detail

      • makeSliceIterator

        public SequenceIterator makeSliceIterator​(int min,
                                          int max)
        Create a new ArrayIterator over the same items, with a different start point and end point
        Parameters:
        min - the start position (1-based) of the new ArrayIterator relative to the original
        max - the end position (1-based) of the last item to be delivered by the new ArrayIterator, relative to the original. For example, min=2, max=3 delivers the two items ($base[2], $base[3]). Set this to Integer.MAX_VALUE if there is no end limit.
        Returns:
        an iterator over the items between the min and max positions

      • hasNext

        public boolean hasNext()
        Test whether there are any more items
        Specified by:
        hasNext in interface LookaheadIterator
        Returns:
        true if there are more items

      • position

        public int position()
        Get the position of the current item in the array
        Specified by:
        position in interface SequenceIterator
        Specified by:
        position in interface UnfailingIterator
        Returns:
        the current position (starting at 1 for the first item)

      • getLastPosition

        public int getLastPosition()
        Get the number of items in the part of the array being processed
        Specified by:
        getLastPosition in interface LastPositionFinder
        Returns:
        the number of items; equivalently, the position of the last item

      • close

        public void close()
        Description copied from interface: SequenceIterator
        Close the iterator. This indicates to the supplier of the data that the client does not require any more items to be delivered by the iterator. This may enable the supplier to release resources. After calling close(), no further calls on the iterator should be made; if further calls are made, the effect of such calls is undefined.

        (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.)

        Specified by:
        close in interface SequenceIterator

      • getArray

        public Item[] getArray()
        Get the underlying array
        Returns:
        the underlying array being processed by the iterator

      • getStartPosition

        public int getStartPosition()
        Get the initial start position
        Returns:
        the start position of the iterator in the array (zero-based)

      • getEndPosition

        public int getEndPosition()
        Get the end position in the array
        Returns:
        the position in the array (zero-based) of the first item not included in the iteration

      • materialize

        public GroundedValue materialize()
        Return a SequenceValue containing all the items in the sequence returned by this SequenceIterator
        Specified by:
        materialize in interface GroundedIterator
        Returns:
        the corresponding SequenceValue