Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

MidpointRounding.AwayFromZero przy decimal.Round

Wybierz jawną regułę remisu: zaokrąglaj do najbliższej wartości, a dokładnie w połowie wybieraj wynik o większej wartości bezwzględnej.

Wersja: C# 12 and .NET 8; later runtimes may add compatible features

Składnia

public static decimal Round(decimal d, int decimals, System.MidpointRounding mode);
public static decimal Round(decimal d, System.MidpointRounding mode);

// Call with an explicit midpoint rule:
decimal rounded = decimal.Round(2.25m, 1, System.MidpointRounding.AwayFromZero);

W C# 12 i .NET 8 wywołanie decimal.Round(d, decimals, MidpointRounding.AwayFromZero) zwraca decimal, czyli System.Decimal. AwayFromZero to element typu wyliczeniowego System.MidpointRounding, przekazywany jako argument mode metody statycznej. Sufiks m oznacza literał typu decimal, a nie double.

Metoda wybiera najbliższą wartość na wskazanej pozycji dziesiętnej. Tylko przy dokładnym remisie AwayFromZero wybiera wartość o większym module: do jednego miejsca 2.25m daje 2.3m, a -2.25m daje -2.3m. Poza remisem 2.24m daje 2.2m. Domyślne ToEven w decimal.Round(d, decimals) przy remisie wybiera wynik z parzystą ostatnią zachowaną cyfrą. Natomiast kierunkowy tryb ToZero zaokrągla w stronę zera także poza remisami.

decimals to liczba miejsc po separatorze dziesiętnym, od 0 do 28 włącznie. decimal.Round(d, mode) zaokrągla do liczby całkowitej, nadal zwracając decimal. W przeciążeniu z trzema argumentami decimals spoza zakresu powoduje ArgumentOutOfRangeException, a niezdefiniowana wartość mode — ArgumentException.

Przykłady

using System;
using System.Globalization;

decimal[] values = [2.25m, -2.25m, 2.24m, 2.26m];

Console.WriteLine("Input | Default | AwayFromZero");
foreach (decimal value in values)
{
    decimal defaultResult = decimal.Round(value, 1);
    decimal explicitResult = decimal.Round(value, 1, MidpointRounding.AwayFromZero);
    Console.WriteLine(string.Create(CultureInfo.InvariantCulture,
        $"{value:F2} | {defaultResult:F1} | {explicitResult:F1}"));
}

Wynik

Input | Default | AwayFromZero
2.25 | 2.2 | 2.3
-2.25 | -2.2 | -2.3
2.24 | 2.2 | 2.2
2.26 | 2.3 | 2.3

Porównaj kolumny: tryby różnią się tylko w dwóch wierszach z dokładnym remisem. `CultureInfo.InvariantCulture` zapewnia kropkę dziesiętną na wyjściu.

Powiązane lekcje

  • C# · Lekcja 7 · Zaawansowany · Wersja: 3

Źródła