Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

MidpointRounding.AwayFromZero avec decimal.Round

Arrondissez à la valeur la plus proche et, uniquement à mi-chemin, choisissez la valeur absolue la plus grande.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

public static decimal Round(decimal d, int decimals, System.MidpointRounding mode);
public static decimal Round(decimal d, System.MidpointRounding mode);

// Call with an explicit midpoint rule:
decimal rounded = decimal.Round(2.25m, 1, System.MidpointRounding.AwayFromZero);

Avec C# 12 et .NET 8, decimal.Round(d, decimals, MidpointRounding.AwayFromZero) renvoie un decimal, l’alias C# de System.Decimal. AwayFromZero est un membre de l’énumération System.MidpointRounding, passé à la méthode statique comme argument mode. Le suffixe m indique un littéral de type decimal, et non double.

La méthode choisit la valeur la plus proche au rang décimal demandé. Uniquement si les deux valeurs sont à égale distance, AwayFromZero choisit celle dont la valeur absolue est la plus grande : à une décimale, 2.25m donne 2.3m et -2.25m donne -2.3m. Hors de ce cas, 2.24m donne 2.2m. La règle par défaut ToEven de decimal.Round(d, decimals) départage les valeurs en choisissant le résultat dont le dernier chiffre conservé est pair. Le mode dirigé ToZero, lui, arrondit vers zéro même hors des cas d’égalité.

decimals indique le nombre de chiffres après le séparateur décimal, de 0 à 28 inclus. decimal.Round(d, mode) arrondit à un entier mais renvoie toujours un decimal. Dans la surcharge à trois arguments, une valeur hors limites pour decimals déclenche ArgumentOutOfRangeException et une valeur non définie pour mode déclenche ArgumentException.

Exemples

using System;
using System.Globalization;

decimal[] values = [2.25m, -2.25m, 2.24m, 2.26m];

Console.WriteLine("Input | Default | AwayFromZero");
foreach (decimal value in values)
{
    decimal defaultResult = decimal.Round(value, 1);
    decimal explicitResult = decimal.Round(value, 1, MidpointRounding.AwayFromZero);
    Console.WriteLine(string.Create(CultureInfo.InvariantCulture,
        $"{value:F2} | {defaultResult:F1} | {explicitResult:F1}"));
}

Résultat

Input | Default | AwayFromZero
2.25 | 2.2 | 2.3
-2.25 | -2.2 | -2.3
2.24 | 2.2 | 2.2
2.26 | 2.3 | 2.3

Comparez les colonnes : les modes ne diffèrent que sur les deux lignes où les valeurs sont exactement à mi-chemin. `CultureInfo.InvariantCulture` impose le point décimal dans la sortie.

Leçons associées

  • C# · Leçon 7 · Avancé · Version : 3

Sources