XSLT, 2nd Edition

Name

floor()

Returns the largest integer that is not greater than the argument.

Syntax

[1.0] number floor(number)
[2.0] numeric? floor(numeric?)

Inputs

A number.

[1.0] If the argument is not a number, it is transformed into a number as if it had been processed by the number() function. If the argument cannot be transformed into a number, the floor() function returns the value NaN (not a number).

[2.0] In XSLT 2.0, the argument must be one of the four numeric types (xs:float, xs:decimal, xs:double, or xs:integer). If it is not, the XSLT processor raises an error. The result of the floor() function will be of the same type as the argument.

In XSLT 2.0, the argument must be a number. If it is not, the XSLT processor raises an error.

Output

The largest integer that is not less than the argument.

[1.0] In XSLT 1.0, floor() returns NaN if the argument cannot be converted to a number.

[2.0] In XSLT 2.0, floor() raises an error if the argument cannot be converted to a number.

Defined in

[1.0] XPath section 4.4, “Number Functions.”

[2.0] XQuery 1.0 and XPath 2.0 Functions and Operators section 6.4, “Functions on Numeric Values.”

Example

The following stylesheet shows the results of invoking the floor() function against a variety of values:

<?xml version="1.0"?>
<!-- floor.xsl --> <xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:output method="text"/> <xsl:template match="/"> <xsl:text>&#xA;Tests of the floor() function:&#xA;&#xA;</xsl:text> <xsl:text> floor(7.983) = </xsl:text> ...