Package net.sf.saxon.expr
Class CastableExpression
java.lang.Object
net.sf.saxon.expr.ComputedExpression
net.sf.saxon.expr.UnaryExpression
net.sf.saxon.expr.CastableExpression
- All Implemented Interfaces:
Serializable
,SourceLocator
,Container
,Expression
,InstructionInfoProvider
Castable Expression: implements "Expr castable as atomic-type?".
The implementation simply wraps a cast expression with a try/catch.
- See Also:
-
Field Summary
FieldsFields inherited from class net.sf.saxon.expr.UnaryExpression
operand
Fields inherited from class net.sf.saxon.expr.ComputedExpression
locationId, staticProperties
Fields inherited from interface net.sf.saxon.expr.Expression
EVALUATE_METHOD, ITERATE_METHOD, PROCESS_METHOD
-
Constructor Summary
ConstructorsConstructorDescriptionCastableExpression
(Expression source, AtomicType target, boolean allowEmpty) -
Method Summary
Modifier and TypeMethodDescriptionint
Determine the static cardinality.int
Determine the special properties of this expressionprotected String
displayOperator
(Configuration config) Give a string representation of the operator for use in diagnosticsboolean
effectiveBooleanValue
(XPathContext context) Get the effective boolean value of the expression.boolean
Is this expression the same as another expression?evaluateItem
(XPathContext context) Evaluate the expressionDetermine the data type of the result of the Castable expressionoptimize
(Optimizer opt, StaticContext env, ItemType contextItemType) Optimize the expressionsimplify
(StaticContext env) Simplify the expressiontypeCheck
(StaticContext env, ItemType contextItemType) Type-check the expressionMethods inherited from class net.sf.saxon.expr.UnaryExpression
display, getBaseExpression, hashCode, iterateSubExpressions, promote, replaceSubExpression
Methods inherited from class net.sf.saxon.expr.ComputedExpression
adoptChildExpression, checkPermittedContents, computeDependencies, computeStaticProperties, doPromotion, dynamicError, evaluateAsString, getCardinality, getColumnNumber, getConstructType, getDependencies, getExecutable, getHostLanguage, getImplementationMethod, getInstructionInfo, getIntrinsicDependencies, getLineNumber, getLocationId, getLocationProvider, getParentExpression, getPublicId, getSlotsUsed, getSpecialProperties, getSystemId, hasBadParentPointer, iterate, markTailFunctionCalls, process, resetStaticProperties, setLocationId, setParentExpression, setParentExpression, suppressValidation, typeError
-
Field Details
-
targetType
AtomicType targetType -
allowEmpty
boolean allowEmpty
-
-
Constructor Details
-
CastableExpression
-
-
Method Details
-
simplify
Simplify the expression- Specified by:
simplify
in interfaceExpression
- Overrides:
simplify
in classUnaryExpression
- Parameters:
env
- the static context- Returns:
- the simplified expression
- Throws:
XPathException
- if an error is discovered during expression rewriting
-
typeCheck
Type-check the expression- Specified by:
typeCheck
in interfaceExpression
- Overrides:
typeCheck
in classUnaryExpression
- Parameters:
env
- the static context of the expressioncontextItemType
- 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 toType.ITEM_TYPE
- Returns:
- the original expression, rewritten to perform necessary run-time type checks, and to perform other type-related optimizations
- Throws:
XPathException
-
optimize
public Expression optimize(Optimizer opt, StaticContext env, ItemType contextItemType) throws XPathException Optimize the expression- Specified by:
optimize
in interfaceExpression
- Overrides:
optimize
in classUnaryExpression
- Parameters:
opt
- the optimizer in use. This provides access to supporting functions; it also allows different optimization strategies to be used in different circumstances.env
- the static context of the expressioncontextItemType
- 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 toType.ITEM_TYPE
- Returns:
- the original expression, rewritten if appropriate to optimize execution
- Throws:
XPathException
-
equals
Is this expression the same as another expression?- Overrides:
equals
in classUnaryExpression
-
getItemType
Determine the data type of the result of the Castable expression- Specified by:
getItemType
in interfaceExpression
- Overrides:
getItemType
in classUnaryExpression
- Parameters:
th
-- Returns:
- the item type of the items in the result sequence, insofar as this is known statically.
-
computeCardinality
public int computeCardinality()Description copied from class:UnaryExpression
Determine the static cardinality. Default implementation returns the cardinality of the operand- Overrides:
computeCardinality
in classUnaryExpression
-
computeSpecialProperties
public int computeSpecialProperties()Determine the special properties of this expression- Overrides:
computeSpecialProperties
in classUnaryExpression
- Returns:
StaticProperty.NON_CREATIVE
.
-
evaluateItem
Evaluate the expression- Specified by:
evaluateItem
in interfaceExpression
- Overrides:
evaluateItem
in classComputedExpression
- Parameters:
context
- The context in which the expression is to be evaluated- Returns:
- the node or atomic value that results from evaluating the expression; or null to indicate that the result is an empty sequence
-
effectiveBooleanValue
Description copied from class:ComputedExpression
Get the effective boolean value of the expression. This returns false if the value is the empty sequence, a zero-length string, a number equal to zero, or the boolean false. Otherwise it returns true.- Specified by:
effectiveBooleanValue
in interfaceExpression
- Overrides:
effectiveBooleanValue
in classComputedExpression
- Parameters:
context
- The context in which the expression is to be evaluated- Returns:
- the effective boolean value
-
displayOperator
Give a string representation of the operator for use in diagnostics- Specified by:
displayOperator
in classUnaryExpression
- Parameters:
config
-- Returns:
- the operator, as a string
-