public class SequenceExtent extends java.lang.Object implements GroundedValue
Constructor and Description |
---|
SequenceExtent(Item[] items)
Construct an sequence from an array of items.
|
SequenceExtent(java.util.List<? extends Item> list)
Construct a SequenceExtent from a List.
|
SequenceExtent(SequenceExtent ext,
int start,
int length)
Construct a SequenceExtent as a view of another SequenceExtent
|
SequenceExtent(SequenceIterator iter)
Construct a sequence containing all the remaining items in a SequenceIterator.
|
Modifier and Type | Method and Description |
---|---|
boolean |
effectiveBooleanValue()
Get the effective boolean value
|
int |
getCardinality()
Determine the cardinality
|
int |
getLength()
Get the number of items in the sequence
|
java.lang.String |
getStringValue()
Get the string value of this sequence.
|
java.lang.CharSequence |
getStringValueCS()
Get the string value of this sequence.
|
Item |
head()
Get the first item in the sequence.
|
Item |
itemAt(int n)
Get the n'th item in the sequence (starting with 0 as the first item)
|
ListIterator |
iterate()
Return an iterator over this sequence.
|
static GroundedValue |
makeResidue(SequenceIterator iter)
Factory method to make a GroundedValue holding the remaining contents of any SequenceIterator,
that is, the contents that have not yet been read
|
static <T extends Item> |
makeSequenceExtent(java.util.List<T> input)
Factory method to make a Value holding the contents of any List of items
|
static GroundedValue |
makeSequenceExtent(SequenceIterator iter)
Factory method to make a GroundedValue holding the contents of any SequenceIterator.
|
GroundedValue |
reduce()
Reduce the sequence to its simplest form.
|
UnfailingIterator |
reverseIterate()
Return an enumeration of this sequence in reverse order (used for reverse axes)
|
GroundedValue |
subsequence(int start,
int length)
Get a subsequence of the value
|
java.lang.String |
toString() |
public SequenceExtent(Item[] items)
items
- the array of items to be included in the sequencepublic SequenceExtent(SequenceExtent ext, int start, int length)
ext
- The existing SequenceExtentstart
- zero-based offset of the first item in the existing SequenceExtent
that is to be included in the new SequenceExtentlength
- The number of items in the new SequenceExtentpublic SequenceExtent(java.util.List<? extends Item> list)
list
- the list of items to be included in the sequencepublic SequenceExtent(SequenceIterator iter) throws XPathException
iter
- The supplied sequence of items. The returned sequence will contain all
items delivered by repeated calls on next() on this iterator, and the
iterator will be consumed by calling the method.XPathException
- if reading the items using the
SequenceIterator raises an errorpublic static GroundedValue makeSequenceExtent(SequenceIterator iter) throws XPathException
iter
- a Sequence iterator that may or may not be consumed to deliver the items in the sequence.
The iterator must be positioned at the start.EmptySequence
. If it is of length
one, the result will be an Item
. In all other cases, it will be an instance of
SequenceExtent
.XPathException
- if an error occurs processing the values from
the iterator.public static GroundedValue makeResidue(SequenceIterator iter) throws XPathException
iter
- a Sequence iterator that may or may not be consumed to deliver the items in the sequence.
The iterator need not be positioned at the start.EmptySequence
. If it is of length
one, the result will be an Item
. In all other cases, it will be an instance of
SequenceExtent
.XPathException
- if an error occurs processing the values from
the iterator.public static <T extends Item> GroundedValue makeSequenceExtent(java.util.List<T> input)
input
- a List containing the items in the sequenceEmptySequence
. If it is of length
one, the result will be an Item
. In all other cases, it will be an instance of
SequenceExtent
.public java.lang.String getStringValue() throws XPathException
GroundedValue
getStringValue
in interface GroundedValue
XPathException
- if the sequence contains items that have no string value (for example, function items)public java.lang.CharSequence getStringValueCS() throws XPathException
GroundedValue
getStringValueCS
in interface GroundedValue
XPathException
- if the sequence contains items that have no string value (for example, function items)public Item head()
head
in interface GroundedValue
head
in interface Sequence
public int getLength()
getLength
in interface GroundedValue
public int getCardinality()
Cardinality
public Item itemAt(int n)
itemAt
in interface GroundedValue
n
- the position of the required itempublic ListIterator iterate()
iterate
in interface GroundedValue
iterate
in interface Sequence
public UnfailingIterator reverseIterate()
public boolean effectiveBooleanValue() throws XPathException
effectiveBooleanValue
in interface GroundedValue
XPathException
- if the sequence has no effective boolean value (for example a sequence of two integers)public GroundedValue subsequence(int start, int length)
subsequence
in interface GroundedValue
start
- the index of the first item to be included in the result, counting from zero.
A negative value is taken as zero. If the value is beyond the end of the sequence, an empty
sequence is returnedlength
- the number of items to be included in the result. Specify Integer.MAX_VALUE to
get the subsequence up to the end of the base sequence. If the value is negative, an empty sequence
is returned. If the value goes off the end of the sequence, the result returns items up to the end
of the sequencepublic java.lang.String toString()
toString
in class java.lang.Object
public GroundedValue reduce()
reduce
in interface GroundedValue
Copyright (c) 2004-2018 Saxonica Limited. All rights reserved.