System.Math.RoundTo

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function RoundTo(const AValue: Extended; const ADigit: TRoundToEXRangeExtended): Extended;

C++

extern DELPHI_PACKAGE System::Extended __fastcall RoundTo(const System::Extended AValue, const TRoundToEXRangeExtended ADigit);

Properties

Type Visibility Source Unit Parent
function public
System.Math.pas
System.Math.hpp
System.Math System.Math

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 in the range from –20 through 20.

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

See Also