fn:deep-equal
Whether two nodes have the same content and attributes
Description
The fn:deep-equal function returns true if the $parameter1 and $parameter2 sequences contain the same values, in the same order.
Atomic values are compared based on their typed values, using the eq operator. If two atomic values cannot be compared (e.g. because one is a number, and the other is a string), the function returns false rather than raise an error.
Informally, two nodes are deep-equal if they have all the same attributes and have children (in the same order) who are themselves deep-equal.
This description is © Copyright 2007, Priscilla Walmsley. It is excerpted from the book XQuery by Priscilla Walmsley, O'Reilly, 2007. For a complete explanation of this function, please refer to Appendix A of the book.
Arguments and Return Type
| Name | Type | Description |
|---|---|---|
$parameter1 |
item()* |
the first sequence to compare |
$parameter2 |
item()* |
the second sequence to compare |
$collation |
xs:string |
the collation to use for comparing strings |
| return value | xs:boolean |
Examples
let $prod1 := | <product dept='MEN' id='P123'>
<number>784</number>
</product> |
let $prod2 := | <product id='P123' dept='MEN'><!--comment-->
<number>784</number>
</product> |
return |
| XQuery Example | Results |
|---|---|
deep-equal( 1, 1 ) |
true |
deep-equal( (1, 1), (1, 1) ) |
true |
deep-equal( (1, 2), (1.0, 2.0) ) |
true |
deep-equal( (1, 2), (2, 1) ) |
false |
deep-equal( $prod1, $prod2 ) |
true |
deep-equal( $prod1/number, $prod2/number ) |
true |
See Also
| functx:sequence-deep-equal | Whether two sequences have the same XML node content and/or values |
| functx:distinct-deep | The XML nodes with distinct values, taking into account attributes and descendants |
| functx:index-of-deep-equal-node | The position of a node in a sequence, based on contents and attributes |
| functx:is-node-in-sequence-deep-equal | Whether an XML node is in a sequence, based on contents and attributes |
| functx:is-node-among-descendants-deep-equal | Whether an XML node is among the descendants of a sequence, based on contents and attributes |
History
| Published On | Last Updated | Contributor(s) |
|---|---|---|
| 2006-06-27 | 2007-02-26 | W3C, XQuery 1.0 and XPath 2.0 Functions and Operators, http://www.w3.org/TR/xpath-functions/ |
Recommended Reading:
