CKTIS / C#
MidpointRounding – výber pravidla zaokrúhľovania
MidpointRounding určuje pravidlo zaokrúhľovania. ToEven a AwayFromZero vyberajú najbližší výsledok, ale inak riešia hodnoty presne v polovici medzi dvoma možnými výsledkami.
Verzia: .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 je výčtový typ v priestore názvov System, dostupný v .NET 10. Odovzdajte ho napríklad preťaženiu Math.Round(value, digits, mode), kde digits určuje počet desatinných miest. Ide o API knižnice, nie o funkciu syntaxe C#, ktorá by vyžadovala LangVersion=preview.
MidpointRounding.ToEven rieši zhodu výberom výsledku, ktorého posledná zachovaná cifra je párna: pri digits = 0 dáva 2.5m hodnotu 2 a 3.5m hodnotu 4. Tento spôsob sa nazýva bankové zaokrúhľovanie a je predvolený pri preťaženiach Math.Round bez parametra režimu zaokrúhľovania. MidpointRounding.AwayFromZero rieši zhodu výberom výsledku vzdialenejšieho od nuly: 2.5m dáva 3 a -2.5m dáva -3.
Mimo zhôd vyberajú oba režimy najbližší výsledok: 2.1m dáva v oboch prípadoch 2. AwayFromZero teda vždy nezvyšuje absolútnu hodnotu. Pri jednom desatinnom mieste je 3.45m presne v polovici, ale 3.451m nie. Ostatné režimy — ToZero, ToNegativeInfinity a ToPositiveInfinity — zaokrúhľujú všetky hodnoty určeným smerom, nielen hodnoty v polovici.
O výsledku rozhoduje skutočne uložená hodnota. Binárna reprezentácia typu double môže spôsobiť, že zdanlivá desatinná polovica v skutočnosti nie je zhodou. Príklad používa literály decimal s príponou m, aby presne vyjadril uvedené hodnoty, a CultureInfo.InvariantCulture, aby určil formát výstupu.
Príklady
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}");
}Výsledok
value | ToEven | AwayFromZero 2.5 | 2 | 3 3.5 | 4 | 4 -2.5 | -2 | -3 2.1 | 2 | 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.