Package net.sf.saxon.functions
Class DeepEqual
java.lang.Object
net.sf.saxon.functions.AbstractFunction
net.sf.saxon.functions.SystemFunction
net.sf.saxon.functions.CollatingFunctionFixed
net.sf.saxon.functions.DeepEqual
- All Implemented Interfaces:
Callable
,StatefulSystemFunction
,FunctionItem
,GroundedValue
,Item
,Sequence
XSLT 2.0 deep-equal() function, where the collation is already known.
Supports deep comparison of two sequences (of nodes and/or atomic values)
optionally using a collation
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Flag indicating that elements and attributes must have the same type annotation to be considered deep-equalstatic final int
Flag indicating that the is-id and is-idref flags are to be comparedstatic final int
Flag indicating that elements and attributes should always be compared according to their string value, not their typed valuestatic final int
Flag indicating that the variety of the type of a node is to be ignored (for example, a mixed content node can compare equal to an element-only content nodestatic final int
Flag indicating that whitespace text nodes are ignored when comparing element nodesstatic final int
Flag indicating that comment children are taken into account when comparing element or document nodesstatic final int
Flag indicating that two elements should only be considered equal if they have the same in-scope namespacesstatic final int
Flag indicating that two element or attribute nodes are considered equal only if their names use the same namespace prefixstatic final int
Flag indicating that processing instruction nodes are taken into account when comparing element or document nodesstatic final int
Flag indicating that adjacent text nodes in the top-level sequence are to be mergedstatic final int
Flag indicating that a warning message explaining the reason why the sequences were deemed non-equal should be sent to the ErrorListener -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptioncall
(XPathContext context, Sequence[] arguments) Execute a dynamic call to the functionstatic boolean
deepEqual
(SequenceIterator op1, SequenceIterator op2, AtomicComparer comparer, XPathContext context, int flags) Determine when two sequences are deep-equalstatic String
deepEquals
(NodeInfo n1, NodeInfo n2, AtomicComparer comparer, XPathContext context, int flags) Get a name that identifies the class that can be used to evaluate this function in streaming mode, that is, supplying one item or event at a time as it is delivered by the parser.makeFunctionCall
(Expression... arguments) Make an expression that either calls this function, or that is equivalent to a call on this functionMethods inherited from class net.sf.saxon.functions.CollatingFunctionFixed
copy, exportAttributes, getAtomicComparer, getPreAllocatedAtomicComparer, getStringCollator, importAttributes, isSubstringMatchingFunction, preAllocateComparer, setCollationName, setRetainedStaticContext
Methods inherited from class net.sf.saxon.functions.SystemFunction
dependsOnContextItem, dynamicCall, equals, export, exportAdditionalArguments, fixArguments, getArity, getCardinality, getContextNode, getDescription, getDetails, getElaborator, getErrorCodeForTypeErrors, getFunctionItemType, getFunctionName, getIntegerBounds, getNetCost, getOperandRoles, getRequiredType, getResultItemType, getResultItemType, getRetainedStaticContext, getSpecialProperties, getStaticBaseUriString, getUniStringArg, hashCode, isSequenceVariadic, isTrustedResultType, makeCall, makeFunction, makeFunction40, makeOptimizedFunctionCall, resultIfEmpty, setArity, setDetails, supplyTypeInformation, toShortString, toString, typeCheckCaller
Methods inherited from class net.sf.saxon.functions.AbstractFunction
atomize, deepEqual40, deepEquals, effectiveBooleanValue, getAnnotations, getUnicodeStringValue, isArray, isMap, makeNewContext, simplify, typeCheck
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface net.sf.saxon.om.FunctionItem
getGenre
Methods inherited from interface net.sf.saxon.om.GroundedValue
asIterable, concatenate, containsNode, materialize
Methods inherited from interface net.sf.saxon.om.Item
getLength, getStringValue, head, isStreamed, itemAt, iterate, reduce, subsequence
Methods inherited from interface net.sf.saxon.om.Sequence
makeRepeatable
-
Field Details
-
INCLUDE_NAMESPACES
public static final int INCLUDE_NAMESPACESFlag indicating that two elements should only be considered equal if they have the same in-scope namespaces- See Also:
-
INCLUDE_PREFIXES
public static final int INCLUDE_PREFIXESFlag indicating that two element or attribute nodes are considered equal only if their names use the same namespace prefix- See Also:
-
INCLUDE_COMMENTS
public static final int INCLUDE_COMMENTSFlag indicating that comment children are taken into account when comparing element or document nodes- See Also:
-
INCLUDE_PROCESSING_INSTRUCTIONS
public static final int INCLUDE_PROCESSING_INSTRUCTIONSFlag indicating that processing instruction nodes are taken into account when comparing element or document nodes- See Also:
-
EXCLUDE_WHITESPACE_TEXT_NODES
public static final int EXCLUDE_WHITESPACE_TEXT_NODESFlag indicating that whitespace text nodes are ignored when comparing element nodes- See Also:
-
COMPARE_STRING_VALUES
public static final int COMPARE_STRING_VALUESFlag indicating that elements and attributes should always be compared according to their string value, not their typed value- See Also:
-
COMPARE_ANNOTATIONS
public static final int COMPARE_ANNOTATIONSFlag indicating that elements and attributes must have the same type annotation to be considered deep-equal- See Also:
-
WARNING_IF_FALSE
public static final int WARNING_IF_FALSEFlag indicating that a warning message explaining the reason why the sequences were deemed non-equal should be sent to the ErrorListener- See Also:
-
JOIN_ADJACENT_TEXT_NODES
public static final int JOIN_ADJACENT_TEXT_NODESFlag indicating that adjacent text nodes in the top-level sequence are to be merged- See Also:
-
COMPARE_ID_FLAGS
public static final int COMPARE_ID_FLAGSFlag indicating that the is-id and is-idref flags are to be compared- See Also:
-
EXCLUDE_VARIETY
public static final int EXCLUDE_VARIETYFlag indicating that the variety of the type of a node is to be ignored (for example, a mixed content node can compare equal to an element-only content node- See Also:
-
-
Constructor Details
-
DeepEqual
public DeepEqual()
-
-
Method Details
-
makeFunctionCall
Description copied from class:SystemFunction
Make an expression that either calls this function, or that is equivalent to a call on this function- Overrides:
makeFunctionCall
in classSystemFunction
- Parameters:
arguments
- the supplied arguments to the function call- Returns:
- either a function call on this function, or an expression that delivers the same result
-
deepEqual
public static boolean deepEqual(SequenceIterator op1, SequenceIterator op2, AtomicComparer comparer, XPathContext context, int flags) throws XPathException Determine when two sequences are deep-equal- Parameters:
op1
- the first sequenceop2
- the second sequencecomparer
- the comparer to be usedcontext
- the XPathContext itemflags
- 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
-
deepEquals
public static String deepEquals(NodeInfo n1, NodeInfo n2, AtomicComparer comparer, XPathContext context, int flags) throws XPathException - Throws:
XPathException
-
call
Execute a dynamic call to the function- Parameters:
context
- the dynamic evaluation contextarguments
- the values of the arguments, supplied as Sequences.- Returns:
- the result of the evaluation, in the form of a Sequence. It is the responsibility of the callee to ensure that the type of result conforms to the expected result type.
- Throws:
XPathException
- (should not happen)
-
getStreamerName
Description copied from class:SystemFunction
Get a name that identifies the class that can be used to evaluate this function in streaming mode, that is, supplying one item or event at a time as it is delivered by the parser. Special streaming support is generally available in Saxon-EE for all system functions that take a sequence as their argument.- Overrides:
getStreamerName
in classSystemFunction
- Returns:
- a name that identifies a class that supports streamed evaluation of this system
function, or null if no such class is available. The mapping of names to classes is
defined in the Saxon-EE class
StreamerMap
. In non-streaming Saxon editions (HE and PE) the method always returns null.
-