Returns this value rounded to an integral value using “schoolbook rounding.”
SDK
- Xcode 9.0+
Framework
- Swift Standard Library
Declaration
func rounded() -> Double
Return Value
The nearest integral value, or, if two integral values are equally close, the integral value with greater magnitude.
Discussion
The rounded() method uses the .to rounding rule, where a value halfway between two integral values is rounded to the one with greater magnitude. The following example rounds several values using this default rule:
(5.2).rounded()
// 5.0
(5.5).rounded()
// 6.0
(-5.2).rounded()
// -5.0
(-5.5).rounded()
// -6.0
To specify an alternative rule for rounding, use the rounded(_:) method instead.