net.sf.saxon.evpull

Class PullEventTracer

public class PullEventTracer extends Object implements EventIterator

Diagnostic class to display the sequence of events reported by an EventIterator
Constructor Summary
PullEventTracer(EventIterator base, Configuration config)
Create a tracer for pull events
Method Summary
booleanisFlatSequence()
Determine whether the EventIterator returns a flat sequence of events, or whether it can return nested event iterators
static voidmain(String[] args)
Main method for testing only
PullEventnext()
Get the next event in the sequence

Constructor Detail

PullEventTracer

public PullEventTracer(EventIterator base, Configuration config)
Create a tracer for pull events

Parameters: base the event iterator whose events are to be traced config the Saxon configuration

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

main

public static void main(String[] args)
Main method for testing only

Parameters: args not used

Throws: Exception

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