CKTIS / C#
MidpointRounding — een afrondingsregel kiezen
MidpointRounding geeft een afrondingsregel aan. ToEven en AwayFromZero kiezen allebei het dichtstbijzijnde resultaat, maar behandelen waarden die precies tussen twee mogelijke resultaten liggen verschillend.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)MidpointRounding is een enum in de naamruimte System en is beschikbaar in .NET 10. Geef deze bijvoorbeeld door aan een overload zoals Math.Round(value, digits, mode), waarbij digits het aantal decimalen aangeeft. Dit is een bibliotheek-API, geen C#-syntaxisfunctie waarvoor LangVersion=preview nodig is.
MidpointRounding.ToEven lost een gelijke afstand op door het resultaat te kiezen waarvan het laatste behouden cijfer even is: bij digits = 0 wordt 2.5m afgerond op 2 en 3.5m op 4. Dit heet bankiersafronding en is de standaard voor overloads van Math.Round zonder parameter voor de afrondingsmodus. MidpointRounding.AwayFromZero lost een gelijke afstand op door het resultaat te kiezen dat verder van nul ligt: 2.5m wordt 3 en -2.5m wordt -3.
Buiten gevallen met gelijke afstand kiezen beide modi het dichtstbijzijnde resultaat: 2.1m wordt in beide gevallen 2. AwayFromZero verhoogt dus niet altijd de absolute waarde. Bij één decimaal is 3.45m precies halverwege, maar 3.451m niet. De overige modi — ToZero, ToNegativeInfinity en ToPositiveInfinity — ronden alle waarden in een bepaalde richting af, niet alleen waarden halverwege.
De werkelijk opgeslagen waarde bepaalt het resultaat. Door de binaire representatie van double kan een waarde die decimaal gezien halverwege lijkt, toch geen gelijke afstand zijn. Het voorbeeld gebruikt decimal-literals met het achtervoegsel m om de getoonde waarden exact weer te geven, en CultureInfo.InvariantCulture om de uitvoeropmaak vast te leggen.
Voorbeelden
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}");
}Resultaat
value | ToEven | AwayFromZero 2.5 | 2 | 3 3.5 | 4 | 4 -2.5 | -2 | -3 2.1 | 2 | 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.