SAXONICA |

**lowest($nodes-1 as node()*) ==> node()***

**lowest($nodes-1 as node()*, $stored-expression as jt:net.sf.saxon.functions.Evaluate-PreparedExpression) ==> node()?**

This function returns (as a sequence of nodes) the node from $nodes-1 that has the lowest value of the supplied stored expression, evaluated as a number.

If the stored expression is omitted, the function is equivalent to the EXSLT set:lowest() function. It returns the node (or nodes, if there are several) whose numeric value (obtained using number(.)) is lower than any other node in the input sequence.

A stored expression may be obtained as the result of calling
the saxon:expression function.
The stored expression is evaluated for each node in nodes-1 in turn, with that node as the context
node, with the context position equal to the position of that node in $nodes-1, and with the context size
equal to the size of $nodes-1. Any NaN values are ignored. If the nodes is empty, the result
is an empty sequence. If several nodes have the lowest value, the result node is the
one that is first in the order of the input sequence. *This differs from the EXSLT lowest() function, which returns
all the nodes that have the minimum value.*

Example: `saxon:lowest(sale, saxon:expression('@price * @qty'))`

will evaluate price times
quantity for each child <sale> element, and return the node for which this has the lowest
value.