net.sf.saxon.expr
Class MappingIterator
java.lang.Object
net.sf.saxon.expr.MappingIterator
- SequenceIterator
public final class MappingIterator
extends java.lang.Object
MappingIterator merges a sequence of sequences into a single flat
sequence. It takes as inputs an iteration, and a mapping function to be
applied to each Item returned by that iteration. The mapping function itself
returns another iteration. The result is an iteration of the concatenation of all
the iterations returned by the mapping function.
This is a powerful class. It is used, with different mapping functions,
in a great variety of ways. It underpins the way that "for" expressions and
path expressions are evaluated, as well as sequence expressions. It is also
used in the implementation of the document(), key(), and id() functions.
static interface | MappingIterator.StatefulMappingFunction - Interface representing a mapping function that retains state information and that therefore
needs to be cloned if a new mapping iterator is created
|
MappingIterator
public MappingIterator(SequenceIterator base,
MappingFunction action)
Construct a MappingIterator that will apply a specified MappingFunction to
each Item returned by the base iterator.
base
- the base iteratoraction
- the mapping function to be applied
getProperties
public int getProperties()
Get properties of this iterator, as a bit-significant integer.
- getProperties in interface SequenceIterator