Description
The functx:distinct-nodes function returns the distinct nodes (based on node identity) in a sequence. It does this without resorting them in document order (it takes the first occurrence of each distinct node).It is different from the built-in fn:distinct-values function in that it returns nodes rather than atomic values, and it does not take into account the values (content) of the nodes, just their identity.
Note: if you want them to be resorted in document order, or you don't care, you can simply use the expression "$nodes/. " (without the quotes), which works because the slash operator removes duplicates and resorts. The "." in the expression returns the node itself.
Arguments and Return TypeName | Type | Description |
$nodes |
node()* |
the node sequence |
return value |
node()* |
XSLT Function DeclarationSee XQuery definition. | <xsl:function name="functx:distinct-nodes" as="node()*"
xmlns:functx="http://www.functx.com">
<xsl:param name="nodes" as="node()*"/>
<xsl:sequence select="
for $seq in (1 to count($nodes))
return $nodes[$seq][not(functx:is-node-in-sequence(
.,$nodes[position() < $seq]))]
"/>
</xsl:function>
|
Examples<xsl:variable name="in-xml" as="item()*"> | | <test>
<child>1</child>
<child>2</child>
<child>3</child>
<child>3</child>
</test> |
| </xsl:variable> |
XPath Example | Results | Explanation |
---|
functx:distinct-nodes(
($in-xml/child, $in-xml/*) ) |
<child>1</child>
<child>2</child>
<child>3</child>
<child>3</child> |
The two child elements that contain 3 have distinct identities, even if they contain the same content. |
functx:distinct-nodes(
($in-xml/child[3], $in-xml/*) ) |
<child>3</child>
<child>1</child>
<child>2</child>
<child>3</child> |
The 3 appears first because it is first in the input sequence. |
Depends OnSee AlsoHistory |
Recommended Reading:
|