public final class ValueComparison extends BinaryExpression implements ComparisonExpression, Negatable
operand0, operand1, operatorEFFECTIVE_BOOLEAN_VALUE, EVALUATE_METHOD, EVENT_FEED_METHOD, INHERITED_CONTEXT, INSPECTION_CONTEXT, ITEM_FEED_METHOD, ITERATE_METHOD, locationId, MAX_SEQUENCE_LENGTH, MAX_STRING_LENGTH, NAVIGATION_CONTEXT, NODE_VALUE_CONTEXT, PROCESS_METHOD, PUSH_SELECTION, staticProperties, UNBOUNDED_LOWER, UNBOUNDED_UPPER, W3C_CONSUMING, W3C_FREE_RANGING, W3C_GROUP_CONSUMING, W3C_MOTIONLESS, WATCH_METHOD| Constructor and Description |
|---|
ValueComparison(Expression p1,
int op,
Expression p2)
Create a comparison expression identifying the two operands and the operator
|
| Modifier and Type | Method and Description |
|---|---|
int |
computeCardinality()
Determine the static cardinality.
|
boolean |
convertsUntypedToOther()
Determine whether untyped atomic values should be converted to the type of the other operand
|
Expression |
copy()
Copy an expression.
|
boolean |
effectiveBooleanValue(XPathContext context)
Evaluate the effective boolean value of the expression
|
BooleanValue |
evaluateItem(XPathContext context)
Evaluate the expression in a given context
|
protected void |
explainExtraAttribute(ExpressionPresenter out) |
AtomicComparer |
getAtomicComparer()
Get the AtomicComparer used to compare atomic values.
|
ExpressionCompiler |
getExpressionCompiler()
Return the compiler of the ValueComparison expression
|
String |
getExpressionName()
Get a name identifying the kind of expression, in terms meaningful to a user.
|
ItemType |
getItemType(TypeHierarchy th)
Determine the data type of the expression
|
BooleanValue |
getResultWhenEmpty()
Get the result to be returned if one of the operands is an empty sequence
|
int |
getSingletonOperator()
Get the primitive (singleton) operator used: one of Token.FEQ, Token.FNE, Token.FLT, Token.FGT,
Token.FLE, Token.FGE
|
boolean |
isNegatable(ExpressionVisitor visitor)
Check whether this specific instance of the expression is negatable
|
boolean |
needsRuntimeComparabilityCheck()
Determine whether a run-time check is needed to check that the types of the arguments
are comparable
|
Expression |
negate()
Return the negation of this value comparison: that is, a value comparison that returns true()
if and only if the original returns false().
|
Expression |
optimize(ExpressionVisitor visitor,
ExpressionVisitor.ContextItemType contextItemType)
Perform optimisation of an expression and its subexpressions.
|
void |
setAtomicComparer(AtomicComparer comparer)
Set the AtomicComparer used to compare atomic values
|
void |
setResultWhenEmpty(BooleanValue value)
Set the result to be returned if one of the operands is an empty sequence
|
Expression |
typeCheck(ExpressionVisitor visitor,
ExpressionVisitor.ContextItemType contextItemType)
Type-check the expression
|
computeSpecialProperties, displayOperator, equals, explain, explainExtraAttributes, getArguments, getOperands, getOperator, hashCode, isAssociative, isCommutative, isInverse, iterateSubExpressionInfo, iterateSubExpressions, promote, replaceSubExpression, setFlattened, simplify, toStringaddToPathMap, adoptChildExpression, checkForUpdatingSubexpressions, checkPermittedContents, computeDependencies, computeStaticProperties, doPromotion, dynamicError, evaluateAsString, evaluatePendingUpdates, explain, getCardinality, getColumnNumber, getColumnNumber, getConstructType, getContainer, getDependencies, getEvaluationMethod, getExecutable, getHostLanguage, getImplementationMethod, getIntegerBounds, getIntrinsicDependencies, getLineNumber, getLineNumber, getLocationId, getLocationProvider, getObjectName, getProperties, getProperty, getPublicId, getSlotsUsed, getSpecialProperties, getStreamability, getStreamingAdjunct, getSystemId, getSystemId, hasVariableBinding, implementsStaticTypeCheck, isSubtreeExpression, isUpdatingExpression, isVacuousExpression, iterate, iterateEvents, markTailFunctionCalls, process, resetLocalStaticProperties, setContainer, setEvaluationMethod, setFiltered, setLocationId, staticTypeCheck, suppressValidation, toPattern, toStreamingPattern, typeErrorclone, finalize, getClass, notify, notifyAll, wait, wait, waitgetOperandspublic ValueComparison(Expression p1, int op, Expression p2)
p1 - the left-hand operandop - the operator, as a token returned by the Tokenizer (e.g. Token.LT)p2 - the right-hand operandpublic String getExpressionName()
getExpressionName in class Expressionpublic void setAtomicComparer(AtomicComparer comparer)
comparer - the AtomicComparerpublic AtomicComparer getAtomicComparer()
getAtomicComparer in interface ComparisonExpressionpublic int getSingletonOperator()
getSingletonOperator in interface ComparisonExpressionpublic boolean convertsUntypedToOther()
convertsUntypedToOther in interface ComparisonExpressionpublic void setResultWhenEmpty(BooleanValue value)
value - the result to be returned if an operand is empty. Supply null to mean the empty sequence.public BooleanValue getResultWhenEmpty()
public boolean needsRuntimeComparabilityCheck()
public Expression typeCheck(ExpressionVisitor visitor, ExpressionVisitor.ContextItemType contextItemType) throws XPathException
typeCheck in class BinaryExpressionvisitor - 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_TYPEXPathException - if an error is discovered during this phase
(typically a type error)public Expression optimize(ExpressionVisitor visitor, ExpressionVisitor.ContextItemType contextItemType) throws XPathException
This method is called after all references to functions and variables have been resolved to the declaration of the function or variable, and after all type checking has been done.
optimize in class BinaryExpressionvisitor - 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_TYPEXPathException - if an error is discovered during this phase
(typically a type error)public boolean isNegatable(ExpressionVisitor visitor)
isNegatable in interface Negatablepublic Expression negate()
public Expression copy()
copy in class Expressionpublic boolean effectiveBooleanValue(XPathContext context) throws XPathException
effectiveBooleanValue in class Expressioncontext - the given context for evaluationXPathException - if any dynamic error occurs evaluating the
expressionpublic BooleanValue evaluateItem(XPathContext context) throws XPathException
evaluateItem in class Expressioncontext - the given context for evaluationXPathException - if any dynamic error occurs evaluating the
expressionpublic ItemType getItemType(TypeHierarchy th)
getItemType in class Expressionth - the type hierarchy cachepublic int computeCardinality()
computeCardinality in class BinaryExpressionStaticProperty.ALLOWS_ZERO_OR_ONE,
StaticProperty.EXACTLY_ONE, StaticProperty.ALLOWS_ONE_OR_MORE,
StaticProperty.ALLOWS_ZERO_OR_MOREpublic ExpressionCompiler getExpressionCompiler()
getExpressionCompiler in class Expressionprotected void explainExtraAttribute(ExpressionPresenter out)
Copyright (c) 2004-2013 Saxonica Limited. All rights reserved.