System.Math.RoundTo

De RAD Studio API Documentation
Aller à : navigation, rechercher

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);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Math.pas
System.Math.hpp
System.Math System.Math


Description

Arrondit une valeur en virgule flottante au nombre de chiffres spécifié, ou à la puissance de dix spécifiée, en utilisant "l'arrondi de banque".

Appelez RoundTo pour arrondir AValue à la puissance de dix spécifiée.

AValue est la valeur à arrondir.

ADigit indique la puissance de dix à laquelle vous voulez arrondir AValue. Cela peut être toute valeur entre -20 et 20.

RoundTo utilise "l'arrondi de banque" pour déterminer comment arrondir la valeur qui se trouve exactement au milieu des deux valeurs ayant le nombre de chiffres significatifs souhaité. Cette méthode arrondit à un nombre pair dans le cas où AValue n'est pas plus proche d'une des deux valeurs.

Les exemples suivants illustrent l'utilisation de RoundTo :

Expression

Valeur

RoundTo(1234567, 3)

1235000

RoundTo(1.124, -2)

1.12

RoundTo(1.125, -2)

1.12

RoundTo(1.126, -2)

1.23

Attention: Les nombres binaires ne peuvent pas représenter exactement les nombres réels décimaux. Vous risquez de ne pas obtenir le résultat attendu si Digit est un nombre négatif. Par exemple, le nombre réel décimal "1.245" est représenté par "1.245000000000000106..." dans les nombres flottants de type Double. RoundTo(1.245, -2) renverra 1.25, et non 1.24, parce que le nombre est plus grand que le milieu exact entre les deux valeurs qui ont le nombre désiré de chiffres significatifs.


Voir aussi