System.Math.SimpleRoundTo

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function SimpleRoundTo(const AValue: Single; const ADigit: TRoundToRange = -2): Single;
function SimpleRoundTo(const AValue: Double; const ADigit: TRoundToRange = -2): Double;
function SimpleRoundTo(const AValue: Extended; const ADigit: TRoundToRange = -2): Extended;

C++

extern DELPHI_PACKAGE float __fastcall SimpleRoundTo(const float AValue, const TRoundToRange ADigit = (TRoundToRange)(0xfffffffe))/* overload */;

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 à un nombre de chiffres ou puissance de dix spécifié, en utilisant l'arrondi symétrique.

Appelez SimpleRoundTo pour arrondir AValue à une puissance de dix spécifiée.

ADigit indique la puissance de dix à laquelle vous voulez arrondir AValue. Cette valeur doit être comprise dans l'intervalle entre -37 et 37.

SimpleRoundTo renvoie la valeur la plus proche ayant la puissance de dix spécifiée. Dans le cas où AValue se situe exactement au milieu des deux valeurs les plus proches ayant la puissance de dix spécifiée (au-dessus et en dessous), cette fonction renvoie :

  • La valeur vers plus l'infini si AValue est positif.
  • La valeur vers moins l'infini si AValue est négatif et si le mode d'arrondi de la FPU n'est pas défini sur rmUp.

Remarque : Le résultat de cette fonction dépend du mode d'arrondi en cours de la FPU. Vous pouvez modifier le mode d'arrondi de la FPU avec la fonction SetRoundMode.

Les exemples suivants illustrent les résultats de SimpleRoundTo :

Expression Valeur

SimpleRoundTo(1234567, 3)

1235000

SimpleRoundTo(1.234, -2)

1.23

SimpleRoundTo(1.235, -2)

1.24

SimpleRoundTo(-1.235, -2)

-1.23 ou -1.24 (selon le mode d'arrondi en cours de la FPU)

Pour arrondir en mode de banque, utilisez System.Math.RoundTo.

Voir aussi