XSLT, 2nd Edition

Name

ceiling()

Returns the smallest integer that is not less than the argument.

Syntax

[1.0] number? ceiling(number?)
[2.0] numeric? ceiling(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 ceiling() 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 ceiling() function will be of the same type as the argument.

Output

The smallest integer that is not less than the argument.

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

[2.0] In XSLT 2.0, ceiling() 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 ceiling() function against a variety of values. We’ll use this XML document as input:

<?xml version="1.0" encoding="utf-8"?>
<!-- chocolate.xml --> <report month="8" year="2006"> <title>Chocolate bar sales</title> <brand> <name>Lindt</name> <units>27408</units> </brand> <brand> <name>Callebaut</name> <units>8203</units> </brand> <brand> <name>Valrhona</name> <units>22101</units> </brand> <brand> ...