public class AtomicSequenceConverter extends UnaryExpression
Modifier and Type | Class and Description |
---|---|
static class |
AtomicSequenceConverter.AtomicSequenceMappingFunction
Mapping function wrapped around a converter
|
static class |
AtomicSequenceConverter.ToStringMappingFunction
Mapping function that converts every item in a sequence to a string
|
Modifier and Type | Field and Description |
---|---|
protected Converter |
converter |
static AtomicSequenceConverter.ToStringMappingFunction |
TO_STRING_MAPPER |
operand
EFFECTIVE_BOOLEAN_VALUE, EVALUATE_METHOD, ITEM_FEED_METHOD, ITERATE_METHOD, locationId, MAX_SEQUENCE_LENGTH, MAX_STRING_LENGTH, PROCESS_METHOD, staticProperties, UNBOUNDED_LOWER, UNBOUNDED_UPPER, WATCH_METHOD
Constructor and Description |
---|
AtomicSequenceConverter(Expression sequence,
PlainType requiredItemType)
Constructor
|
Modifier and Type | Method and Description |
---|---|
void |
allocateConverter(Configuration config,
boolean allowNull) |
int |
computeCardinality()
Determine the static cardinality of the expression
|
int |
computeSpecialProperties()
Determine the special properties of this expression
|
Expression |
copy()
Copy an expression.
|
protected String |
displayOperator(Configuration config)
Give a string representation of the operator for use in diagnostics
|
boolean |
equals(Object other)
Is this expression the same as another expression?
|
AtomicValue |
evaluateItem(XPathContext context)
Evaluate as an Item.
|
void |
explain(ExpressionPresenter destination)
Diagnostic print of expression structure.
|
Converter |
getConverter()
Get the converter used to convert the items in the sequence
|
ExpressionCompiler |
getExpressionCompiler()
Return the compiler of the expression
|
String |
getExpressionName()
Get a name identifying the kind of expression, in terms meaningful to a user.
|
ItemType |
getItemType()
Determine the data type of the items returned by the expression, if possible
|
protected OperandRole |
getOperandRole()
Get the usage (in terms of streamability analysis) of the single operand
|
PlainType |
getRequiredItemType()
Get the required item type (the target type of the conversion
|
AtomicSequenceConverterAdjunct |
getStreamingAdjunct()
Get a class that supports streamed evaluation of this expression
|
int |
hashCode()
get HashCode for comparing two expressions.
|
SequenceIterator |
iterate(XPathContext context)
Iterate over the sequence of values
|
Expression |
optimize(ExpressionVisitor visitor,
ContextItemStaticInfo contextItemType)
Perform optimisation of an expression and its subexpressions.
|
void |
setConverter(Converter converter) |
Expression |
simplify(ExpressionVisitor visitor)
Simplify an expression
|
Expression |
typeCheck(ExpressionVisitor visitor,
ContextItemStaticInfo contextInfo)
Type-check the expression
|
getBaseExpression, operands, promote, replaceOperand, toShortString, toString
addToPathMap, adoptChildExpression, checkForUpdatingSubexpressions, checkPermittedContents, clearStreamabilityData, computeDependencies, computeStaticProperties, doPromotion, dynamicError, effectiveBooleanValue, evaluateAsString, evaluatePendingUpdates, explain, getCardinality, getColumnNumber, getConfiguration, getConstructType, getContainer, getDependencies, getEvaluationMethod, getHostLanguage, getImplementationMethod, getIntegerBounds, getIntrinsicDependencies, getLineNumber, getLocationId, getObjectName, getPosture, getProperties, getProperty, getPublicId, getSlotsUsed, getSpecialProperties, getStreamability, getSweep, getSystemId, hasVariableBinding, identityHashCode, implementsStaticTypeCheck, isIdentical, isSubtreeExpression, isUpdatingExpression, isVacuousExpression, iterateEvents, makeStreamingAdjunct, markTailFunctionCalls, operandList, process, resetLocalStaticProperties, setContainer, setEvaluationMethod, setFiltered, setFlattened, setLocationId, setPostureAndSweep, staticTypeCheck, suppressValidation, toPattern, toStreamingPattern, typeError, unordered
public static AtomicSequenceConverter.ToStringMappingFunction TO_STRING_MAPPER
protected Converter converter
public AtomicSequenceConverter(Expression sequence, PlainType requiredItemType)
sequence
- this must be a sequence of atomic values. This is not checked; a ClassCastException
will occur if the precondition is not satisfied.requiredItemType
- the item type to which all items in the sequence should be converted,public void allocateConverter(Configuration config, boolean allowNull)
protected OperandRole getOperandRole()
UnaryExpression
getOperandRole
in class UnaryExpression
public PlainType getRequiredItemType()
public Converter getConverter()
public void setConverter(Converter converter)
public Expression simplify(ExpressionVisitor visitor) throws XPathException
simplify
in class Expression
visitor
- an expression visitorXPathException
- if an error is discovered during expression
rewritingpublic Expression typeCheck(ExpressionVisitor visitor, ContextItemStaticInfo contextInfo) throws XPathException
typeCheck
in class UnaryExpression
visitor
- an expression visitorcontextInfo
- Information available statically about the context item: whether it is (possibly)
absent; its static type; its streaming posture.XPathException
- if an error is discovered during this phase
(typically a type error)public Expression optimize(ExpressionVisitor visitor, ContextItemStaticInfo contextItemType) throws XPathException
optimize
in class UnaryExpression
visitor
- an expression visitorcontextItemType
- the static type of "." at the point where this expression is invoked.
The parameter is set to null if it is known statically that the context item will be undefined.
If the type of the context item is not known statically, the argument is set to
Type.ITEM_TYPE
XPathException
- if an error is discovered during this phase
(typically a type error)public int computeSpecialProperties()
computeSpecialProperties
in class UnaryExpression
StaticProperty.NON_CREATIVE
.public AtomicSequenceConverterAdjunct getStreamingAdjunct()
getStreamingAdjunct
in class Expression
public Expression copy()
copy
in class Expression
public SequenceIterator iterate(XPathContext context) throws XPathException
iterate
in class Expression
context
- supplies the context for evaluationXPathException
- if any dynamic error occurs evaluating the
expressionpublic AtomicValue evaluateItem(XPathContext context) throws XPathException
evaluateItem
in class Expression
context
- The context in which the expression is to be evaluatedXPathException
- if any dynamic error occurs evaluating the
expressionpublic ItemType getItemType()
getItemType
in class UnaryExpression
public int computeCardinality()
computeCardinality
in class UnaryExpression
StaticProperty.ALLOWS_ZERO_OR_ONE
,
StaticProperty.EXACTLY_ONE
, StaticProperty.ALLOWS_ONE_OR_MORE
,
StaticProperty.ALLOWS_ZERO_OR_MORE
public boolean equals(Object other)
equals
in class UnaryExpression
public int hashCode()
hashCode
in class UnaryExpression
public ExpressionCompiler getExpressionCompiler()
getExpressionCompiler
in class Expression
public String getExpressionName()
getExpressionName
in class Expression
protected String displayOperator(Configuration config)
UnaryExpression
displayOperator
in class UnaryExpression
config
- the Saxon configurationpublic void explain(ExpressionPresenter destination)
explain
in class UnaryExpression
destination
- the expression presenter used to display the structureCopyright (c) 2004-2014 Saxonica Limited. All rights reserved.