net.sf.saxon.functions
Class DeepEqual

java.lang.Object
  net.sf.saxon.expr.Expression
      net.sf.saxon.expr.FunctionCall
          net.sf.saxon.functions.SystemFunction
              net.sf.saxon.functions.CollatingFunction
                  net.sf.saxon.functions.DeepEqual

All Implemented Interfaces:

Serializable, SourceLocator, LocationProvider, SaxonLocator, EvaluableItem, SequenceIterable, InstructionInfo, Locator

public class DeepEqual
extends CollatingFunction

XSLT 2.0 deep-equal() function. Supports deep comparison of two sequences (of nodes and/or atomic values) optionally using a collation

See Also:

Serialized Form

Field Summary

static int	COMPARE_ANNOTATIONS Flag indicating that elements and attributes must have the same type annotation to be considered deep-equal
static int	COMPARE_STRING_VALUES Flag indicating that elements and attributes should always be compared according to their string value, not their typed value
static int	EXCLUDE_WHITESPACE_TEXT_NODES Flag indicating that whitespace text nodes are ignored when comparing element nodes
static int	INCLUDE_COMMENTS Flag indicating that comment children are taken into account when comparing element or document nodes
static int	INCLUDE_NAMESPACES Flag indicating that two elements should only be considered equal if they have the same in-scope namespaces
static int	INCLUDE_PREFIXES Flag indicating that two element or attribute nodes are considered equal only if their names use the same namespace prefix
static int	INCLUDE_PROCESSING_INSTRUCTIONS Flag indicating that processing instruction nodes are taken into account when comparing element or document nodes
static int	JOIN_ADJACENT_TEXT_NODES Flag indicating that adjacent text nodes in the top-level sequence are to be merged
static int	WARNING_IF_FALSE Flag indicating that a warning message explaining the reason why the sequences were deemed non-equal should be sent to the ErrorListener

Fields inherited from class net.sf.saxon.functions.CollatingFunction

stringCollator

Fields inherited from class net.sf.saxon.functions.SystemFunction

operation

Fields inherited from class net.sf.saxon.expr.FunctionCall

argument

Fields inherited from class net.sf.saxon.expr.Expression

EVALUATE_METHOD, EVENT_FEED_METHOD, ITEM_FEED_METHOD, ITERATE_METHOD, locationId, PROCESS_METHOD, PUSH_SELECTION, staticProperties, WATCH_METHOD

Constructor Summary

DeepEqual()

Method Summary

static boolean	deepEquals(SequenceIterator op1, SequenceIterator op2, GenericAtomicComparer collator, Configuration config, int flags) Determine when two sequences are deep-equal
Item	evaluateItem(XPathContext context) Evaluate the expression
Expression	preEvaluate(ExpressionVisitor visitor) preEvaluate: if all arguments are known statically, evaluate early

Methods inherited from class net.sf.saxon.functions.CollatingFunction

checkArguments, copy, getAbsoluteCollationURI, getAtomicComparer, getCollator, getExpressionBaseURI, getStringCollator

Methods inherited from class net.sf.saxon.functions.SystemFunction

addContextDocumentArgument, addDocToPathMap, computeCardinality, computeSpecialProperties, getDetails, getErrorCodeForTypeErrors, getImplementationMethod, getItemType, getRequiredType, makeSystemFunction, optimize, setDetails, useContextItemAsDefault

Methods inherited from class net.sf.saxon.expr.FunctionCall

addExternalFunctionCallToPathMap, checkArgumentCount, equals, explain, getArguments, getDisplayName, getExpressionName, getFunctionName, getNumberOfArguments, hashCode, iterateSubExpressions, promote, replaceSubExpression, setArguments, setFunctionName, simplify, simplifyArguments, toString, typeCheck

Methods inherited from class net.sf.saxon.expr.Expression

addToPathMap, adoptChildExpression, checkForUpdatingSubexpressions, checkPermittedContents, computeDependencies, computeStaticProperties, doPromotion, dynamicError, effectiveBooleanValue, evaluateAsString, evaluatePendingUpdates, explain, getCardinality, getColumnNumber, getColumnNumber, getConstructType, getContainer, getDependencies, getEvaluationMethod, getExecutable, getHostLanguage, getIntrinsicDependencies, getLineNumber, getLineNumber, getLocationId, getLocationProvider, getObjectName, getProperties, getProperty, getPublicId, getSlotsUsed, getSpecialProperties, getSystemId, getSystemId, hasLoopingSubexpression, implementsStaticTypeCheck, isSubtreeExpression, isUpdatingExpression, isVacuousExpression, iterate, iterateEvents, iterateSameFocusSubExpressions, markTailFunctionCalls, process, resetLocalStaticProperties, setContainer, setEvaluationMethod, setFiltered, setFlattened, setLocationId, staticTypeCheck, suppressValidation, typeError

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

INCLUDE_NAMESPACES

public static final int INCLUDE_NAMESPACES

Flag indicating that two elements should only be considered equal if they have the same in-scope namespaces

See Also:

Constant Field Values

INCLUDE_PREFIXES

public static final int INCLUDE_PREFIXES

Flag indicating that two element or attribute nodes are considered equal only if their names use the same namespace prefix

See Also:

Constant Field Values

INCLUDE_COMMENTS

public static final int INCLUDE_COMMENTS

Flag indicating that comment children are taken into account when comparing element or document nodes

See Also:

Constant Field Values

INCLUDE_PROCESSING_INSTRUCTIONS

public static final int INCLUDE_PROCESSING_INSTRUCTIONS

Flag indicating that processing instruction nodes are taken into account when comparing element or document nodes

See Also:

Constant Field Values

EXCLUDE_WHITESPACE_TEXT_NODES

public static final int EXCLUDE_WHITESPACE_TEXT_NODES

Flag indicating that whitespace text nodes are ignored when comparing element nodes

See Also:

Constant Field Values

COMPARE_STRING_VALUES

public static final int COMPARE_STRING_VALUES

Flag indicating that elements and attributes should always be compared according to their string value, not their typed value

See Also:

Constant Field Values

COMPARE_ANNOTATIONS

public static final int COMPARE_ANNOTATIONS

Flag indicating that elements and attributes must have the same type annotation to be considered deep-equal

See Also:

Constant Field Values

WARNING_IF_FALSE

public static final int WARNING_IF_FALSE

Flag indicating that a warning message explaining the reason why the sequences were deemed non-equal should be sent to the ErrorListener

See Also:

Constant Field Values

JOIN_ADJACENT_TEXT_NODES

public static final int JOIN_ADJACENT_TEXT_NODES

Flag indicating that adjacent text nodes in the top-level sequence are to be merged

See Also:

Constant Field Values

Constructor Detail

DeepEqual

public DeepEqual()

Method Detail

preEvaluate

public Expression preEvaluate(ExpressionVisitor visitor)
                       throws XPathException

preEvaluate: if all arguments are known statically, evaluate early

Overrides:

preEvaluate in class FunctionCall

Parameters:

visitor - an expression visitor

Returns:

the result of the early evaluation, or the original expression, or potentially a simplified expression

Throws:

XPathException

evaluateItem

public Item evaluateItem(XPathContext context)
                  throws XPathException

Evaluate the expression

Specified by:

evaluateItem in interface EvaluableItem

Overrides:

evaluateItem in class Expression

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

Throws:

XPathException - if any dynamic error occurs evaluating the expression

deepEquals

public static boolean deepEquals(SequenceIterator op1,
                                 SequenceIterator op2,
                                 GenericAtomicComparer collator,
                                 Configuration config,
                                 int flags)
                          throws XPathException

Determine when two sequences are deep-equal

Parameters:

op1 - the first sequence

op2 - the second sequence

collator - the collator to be used

config - the configuration (gives access to the NamePool)

flags - bit-significant integer giving comparison options. Always zero for standard F+O deep-equals comparison.

Returns:

true if the sequences are deep-equal

Throws:

XPathException - if either sequence contains a function item