## 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

Copyright (c) 2004-2010 Saxonica Limited. All rights reserved.