CKTIS / C#
MidpointRounding — wybór reguły zaokrąglania
MidpointRounding określa regułę zaokrąglania. ToEven i AwayFromZero wybierają najbliższy wynik, lecz inaczej rozstrzygają przypadki dokładnie w połowie między dwoma wynikami.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)MidpointRounding to typ wyliczeniowy z przestrzeni nazw System, dostępny w .NET 10. Przekaż go np. do Math.Round(value, digits, mode), gdzie digits oznacza liczbę miejsc po przecinku. Jest to API biblioteki, a nie funkcja składni C# wymagająca LangVersion=preview.
MidpointRounding.ToEven przy remisie wybiera wynik z parzystą ostatnią zachowaną cyfrą: 2.5m daje 2, a 3.5m daje 4 przy digits = 0. To tzw. zaokrąglanie bankierskie, domyślne w przeciążeniach Math.Round bez parametru trybu. MidpointRounding.AwayFromZero przy remisie wybiera wynik dalej od zera: 2.5m daje 3, a -2.5m daje -3.
Oba tryby poza remisami wybierają najbliższy wynik: 2.1m daje 2 w obu przypadkach. AwayFromZero nie oznacza więc stałego zwiększania wartości bezwzględnej. Przy jednym miejscu po przecinku 3.45m jest remisem, ale 3.451m już nim nie jest. Pozostałe tryby — ToZero, ToNegativeInfinity i ToPositiveInfinity — zaokrąglają wszystkie wartości w określonym kierunku, nie tylko remisy.
O wyniku decyduje rzeczywista wartość zapisana w zmiennej. Binarna reprezentacja double może sprawić, że pozorny remis dziesiętny nim nie będzie. Przykład używa literałów decimal z przyrostkiem m, aby dokładnie zapisać pokazane wartości, oraz CultureInfo.InvariantCulture, aby ustalić format wyjścia.
Przykłady
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}");
}Wynik
value | ToEven | AwayFromZero 2.5 | 2 | 3 3.5 | 4 | 4 -2.5 | -2 | -3 2.1 | 2 | 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.