EXSLT - set:difference - Implementer Page

Version: 1
Status: stable
User Page: index.html
XML Definition: set.difference.xml
Function Package: set.difference.zip

Function Syntax

node-set set:difference(node-set, node-set)

Template Syntax

<xsl:call-template name="set:difference">
   <xsl:with-param name="nodes1" select="node-set" />
   <xsl:with-param name="nodes2" select="node-set" />
</xsl:call-template>

The set:difference function returns the difference between two node sets - those nodes that are in the node set passed as the first argument that are not in the node set passed as the second argument.

The set:difference template applies templates to these nodes in set:difference mode. By default, the nodes are copied by this template, so that a result tree fragment consisting of the nodes is returned.

An implementation of this extension function in the EXSLT set namespace must conform to the behaviour described in this document.

Implementations

Built-in support for set:difference is available in the following XSLT processors:

Processor	Processor Version	Implemented Version
4XSLT, from 4Suite.	0.12.0a3	1
SAXON from Michael Kay	6.3	1
jd.xslt from Johannes Döbler	1.0.9	1
libxslt from Daniel Veillard; implementation by Thomas Broyer	1.0.19	1
Xalan-J from Apache	2.4.D1	1

The following implementations of set:difference are available:

Language	Implemented Version	Creator	Date	Download
XSLT Template	1	Jeni Tennison	2001-03-28	set.difference.template.xsl
EXSLT Function	1	Jeni Tennison	2001-03-28	set.difference.function.xsl

Use Cases

Use Case Package: set.difference.use-cases.zip

The following use cases illustrate the functionality of set:difference.

Details	Calling Stylesheet	XML Data	Expected Result	Category	Template
1	set.difference.1.xsl	set.difference.data.1.xml	set.difference.result.1.xml	example	N

Change History

Submitted: 2001-03-28
Creator: Jeni Tennison(http://www.jenitennison.com)

Returns the nodes in the first node set that are not in the second node set.

Version	Modified	By	Details
1.1	2001-05-08	Jeni Tennison	Added a description of how the template-equivalent to the function works.
1.2	2001-05-22	Jeni Tennison	Added vendor implementations in Saxon and 4XSLT Changed status to stable
1.3	2001-06-11	Jeni Tennison	Added vendor implementation in jd.xslt.
1.4	2001-08-23	Jeni Tennison	Added vendor implementation in libxslt.
1.5	2002-08-20	Craig Stewart	Added Xalan-J implementation to the list.
1.6	2002-11-12	Craig Stewart	Updated 4XSLT version to 0.12.0a3.

Copyright

This material is in the public domain.