Math.RoundTo
Contents |
Delphi Information
From Math.pas
function RoundTo(const AValue: Extended; const ADigit: TRoundToEXRangeExtended): Extended;
Unit: Math
Type: function
Visibility: public
C++ Information
From Math.hpp
long double __fastcall RoundTo(long double AValue, signed char ADigit);
Unit: Math
Type: function
Description
Rounds a floating-point value to a specified digit or power of ten using "Banker's rounding".
Call RoundTo to round AValue to a specified power of ten.
AValue is the value to round.
ADigit indicates the power of ten to which you want AValue rounded. It can be any value from –37 to 37 (inclusive).
RoundTo uses "Banker's Rounding" to determine how to round values that are exactly midway between the two values that have the desired number of significant digits. This method rounds to an even number in the case that AValue is not nearer to either value.
The following examples illustrate the use of RoundTo:
| Expression | Value |
|---|---|
|
RoundTo(1234567, 3) |
1235000 |
|
RoundTo(1.234, -2) |
1.23 |
|
RoundTo(1.235, -2) |
1.24 |
|
RoundTo(1.245, -2) |
1.24 |
Note: The behavior of RoundTo can be affected by the Set8087CW procedure or SetRoundMode function.