CKTIS / C#
MidpointRounding — choisir une règle d’arrondi
MidpointRounding définit une règle d’arrondi. ToEven et AwayFromZero choisissent tous deux le résultat le plus proche, mais traitent différemment les valeurs exactement à mi-chemin entre deux résultats possibles.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)MidpointRounding est une énumération de l’espace de noms System, disponible dans .NET 10. Passez-la, par exemple, à une surcharge telle que Math.Round(value, digits, mode), où digits indique le nombre de décimales. Il s’agit d’une API de bibliothèque, et non d’une fonctionnalité de syntaxe C# nécessitant LangVersion=preview.
MidpointRounding.ToEven tranche une égalité en choisissant le résultat dont le dernier chiffre conservé est pair : avec digits = 0, 2.5m donne 2 et 3.5m donne 4. Cette méthode, appelée arrondi bancaire, est la règle par défaut des surcharges de Math.Round sans paramètre de mode d’arrondi. MidpointRounding.AwayFromZero tranche une égalité en choisissant le résultat le plus éloigné de zéro : 2.5m donne 3 et -2.5m donne -3.
En dehors des égalités, les deux modes choisissent le résultat le plus proche : 2.1m donne 2 dans les deux cas. Ainsi, AwayFromZero n’augmente pas toujours la valeur absolue. À une décimale, 3.45m est à mi-chemin, contrairement à 3.451m. Les autres modes — ToZero, ToNegativeInfinity et ToPositiveInfinity — arrondissent toutes les valeurs dans une direction définie, pas seulement celles à mi-chemin.
C’est la valeur réellement stockée qui détermine le résultat. La représentation binaire de double peut faire qu’une valeur apparemment à mi-chemin en décimal ne soit pas une égalité. L’exemple utilise des littéraux decimal suffixés par m pour représenter exactement les valeurs montrées, et CultureInfo.InvariantCulture pour fixer le format de sortie.
Exemples
using System;
using System.Globalization;
CultureInfo.CurrentCulture = CultureInfo.InvariantCulture;
Console.WriteLine("value | ToEven | AwayFromZero");
foreach (decimal value in new[] { 2.5m, 3.5m, -2.5m, 2.1m })
{
decimal even = Math.Round(value, 0, MidpointRounding.ToEven);
decimal away = Math.Round(value, 0, MidpointRounding.AwayFromZero);
Console.WriteLine($"{value:F1} | {even:F0} | {away:F0}");
}Résultat
value | ToEven | AwayFromZero 2.5 | 2 | 3 3.5 | 4 | 4 -2.5 | -2 | -3 2.1 | 2 | 2
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.