Returns the double integer value closest to this
.
Rounds away from zero when there is no closest integer: (3.5).roundToDouble() == 4
and (-3.5).roundToDouble() == -4
.
If this is already an integer valued double, including -0.0
, or it is a non-finite double value, the value is returned unmodified.
For the purpose of rounding, -0.0
is considered to be below 0.0
, and -0.0
is therefore considered closer to negative numbers than 0.0
. This means that for a value, d
in the range -0.5 < d < 0.0
, the result is -0.0
.
The result is always a double. If this is a numerically large integer, the result may be an infinite double.
double roundToDouble();
© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/2.0.0/dart-core/num/roundToDouble.html