fn:round
Rounds a numeric value
Description
The fn:round function is used to round a numeric value to the nearest integer. If the decimal portion of the number is .5 or greater, it is rounded up to the greater whole number (even if it is negative), otherwise it is rounded down.
The result type depends the numeric type of the argument. If $arg is untyped, it is cast to xs:double.
This description is © Copyright 2007, Priscilla Walmsley. It is excerpted from the book XQuery by Priscilla Walmsley, O'Reilly, 2007. For a complete explanation of this function, please refer to Appendix A of the book.
Arguments and Return Type
| Name | Type |
|---|---|
$arg |
numeric? |
| return value | numeric? |
Examples
| XPath Example | Results |
|---|---|
round(5) |
5 |
round(5.1) |
5 |
round(5.5) |
6 |
round(-5.5) |
-5 |
round(-5.51) |
-6 |
See Also
| fn:ceiling | Rounds up to the next highest integer |
| fn:floor | Rounds down to the next lowest integer |
| fn:round-half-to-even | Rounds a numeric value, rounding even halfs to the nearest even number |
History
| Published On | Last Updated | Contributor(s) |
|---|---|---|
| 2006-06-27 | 2007-02-26 | W3C, XQuery 1.0 and XPath 2.0 Functions and Operators, http://www.w3.org/TR/xpath-functions/ |
Recommended Reading:
