EXSLT - math:lowest - Implementer Page

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

Function Syntax

node-set math:lowest(node-set)

Template Syntax

<xsl:call-template name="math:lowest">
   <xsl:with-param name="nodes" select="node-set" />
</xsl:call-template>

The math:lowest function returns the nodes in the node set whose value is the minimum value for the node set. The minimum value for the node set is the same as the value as calculated by math:min. A node has this minimum value if the result of converting its string value to a number as if by the number function is equal to the minimum value, where the equality comparison is defined as a numerical comparison using the = operator.

If any of the nodes in the node set has a non-numeric value, the math:min function will return NaN. The definition numeric comparisons entails that NaN != NaN. Therefore if any of the nodes in the node set has a non-numeric value, math:lowest will return an empty node set.

The math:lowest template returns a result tree fragment consisting of copies of the nodes as returned by the function.

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

Implementations

Built-in support for math:lowest 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 math:lowest are available:

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

Use Cases

Use Case Package: math.lowest.use-cases.zip

The following use cases illustrate the functionality of math:lowest.

Details	Calling Stylesheet	XML Data	Expected Result	Category	Template
1	math.lowest.1.xsl	math.lowest.data.1.xml	math.lowest.result.1.xml	example	N
2	math.lowest.2.xsl	math.lowest.data.1.xml	math.lowest.result.1.xml	example	Y
3	math.lowest.1.xsl	math.lowest.data.2.xml	math.lowest.result.2.xml	boundary	N
4	math.lowest.2.xsl	math.lowest.data.2.xml	math.lowest.result.2.xml	boundary	Y
5	math.lowest.3.xsl	math.lowest.data.1.xml	-	error	N
6	math.lowest.4.xsl	math.lowest.data.1.xml	-	error	Y
7	math.lowest.5.xsl	math.lowest.data.5.xml	math.lowest.result.5.xml	example	N

Change History

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

Returns the nodes with the minimum value in a node set.

Version	Modified	By	Details
1.1	2001-04-28	Jeni Tennison	Clarified the wording of the definition, highlighting the fact that a non-numeric value will result in an empty set being returned.
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.