CKTIS / C#
MidpointRounding – výběr pravidla zaokrouhlování
MidpointRounding určuje pravidlo zaokrouhlování. ToEven a AwayFromZero vybírají nejbližší výsledek, ale jinak řeší hodnoty přesně uprostřed mezi dvěma možnými výsledky.
Verze: .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 je výčtový typ v oboru názvů System, dostupný v .NET 10. Předejte ho například přetížení Math.Round(value, digits, mode), kde digits určuje počet desetinných míst. Jde o API knihovny, nikoli o funkci syntaxe C#, která by vyžadovala LangVersion=preview.
MidpointRounding.ToEven řeší shodu výběrem výsledku, jehož poslední zachovaná cifra je sudá: při digits = 0 dává 2.5m hodnotu 2 a 3.5m hodnotu 4. Tomuto způsobu se říká bankovní zaokrouhlování a je výchozí pro přetížení Math.Round bez parametru režimu zaokrouhlování. MidpointRounding.AwayFromZero řeší shodu výběrem výsledku vzdálenějšího od nuly: 2.5m dává 3 a -2.5m dává -3.
Mimo shody vybírají oba režimy nejbližší výsledek: 2.1m dává v obou případech 2. AwayFromZero tedy vždy nezvyšuje absolutní hodnotu. Při jednom desetinném místě je 3.45m přesně uprostřed, ale 3.451m nikoli. Ostatní režimy — ToZero, ToNegativeInfinity a ToPositiveInfinity — zaokrouhlují všechny hodnoty určeným směrem, nejen hodnoty uprostřed.
O výsledku rozhoduje skutečně uložená hodnota. Binární reprezentace typu double může způsobit, že zdánlivá desetinná polovina ve skutečnosti není shodou. Příklad používá literály decimal s příponou m, aby přesně vyjádřil uvedené hodnoty, a CultureInfo.InvariantCulture, aby určil formát výstupu.
Pří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ýsledek
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ýsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.