Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła