net.sf.saxon.evpull

Class TracingEventIterator

public class TracingEventIterator extends Object implements EventIterator

This class is a filter for a sequence of pull events; it returns the input sequence unchanged, but traces execution to System.err
Constructor Summary
TracingEventIterator(EventIterator base)
Create an event iterator that traces all events received from the base sequence, and returns them unchanged
Method Summary
booleanisFlatSequence()
Determine whether the EventIterator returns a flat sequence of events, or whether it can return nested event iterators
PullEventnext()
Get the next event in the sequence

Constructor Detail

TracingEventIterator

public TracingEventIterator(EventIterator base)
Create an event iterator that traces all events received from the base sequence, and returns them unchanged

Parameters: base the iterator over the base sequence

Method Detail

isFlatSequence

public boolean isFlatSequence()
Determine whether the EventIterator returns a flat sequence of events, or whether it can return nested event iterators

Returns: true if the next() method is guaranteed never to return an EventIterator

next

public PullEvent next()
Get the next event in the sequence

Returns: the next event, or null when the sequence is exhausted. Note that since an EventIterator is itself a PullEvent, this method may return a nested iterator.

Throws: net.sf.saxon.trans.XPathException if a dynamic evaluation error occurs