Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje