Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

MidpointRounding.AwayFromZero v decimal.Round

Zaokrúhľujte na najbližšiu hodnotu a iba presne v polovici vyberte výsledok s väčšou absolútnou hodnotou.

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

Syntax

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);

V C# 12 a .NET 8 vracia decimal.Round(d, decimals, MidpointRounding.AwayFromZero) hodnotu typu decimal, čo je alias C# pre System.Decimal. AwayFromZero je člen výčtového typu System.MidpointRounding a statickej metóde sa odovzdáva ako argument mode. Prípona m označuje literál typu decimal, nie double.

Metóda vyberá najbližšiu hodnotu s požadovaným počtom desatinných miest. Iba presne v polovici vyberie AwayFromZero hodnotu s väčšou absolútnou hodnotou: pri jednom desatinnom mieste sa 2.25m zaokrúhli na 2.3m a -2.25m na -2.3m. Mimo presného stredu sa 2.24m zaokrúhli na 2.2m. Predvolené pravidlo ToEven v decimal.Round(d, decimals) pri rovnakej vzdialenosti vyberá výsledok, ktorého posledná ponechaná číslica je párna. Smerový režim ToZero naopak zaokrúhľuje smerom k nule aj mimo presného stredu.

decimals udáva počet miest za desatinným oddeľovačom, od 0 do 28 vrátane. decimal.Round(d, mode) zaokrúhľuje na celé číslo, ale stále vracia decimal. Pri preťažení s tromi argumentmi vyvolá decimals mimo rozsahu výnimku ArgumentOutOfRangeException a nedefinovaná hodnota mode výnimku ArgumentException.

Príklady

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}"));
}

Výsledok

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

Porovnajte stĺpce: režimy sa líšia len v dvoch riadkoch s hodnotami presne v polovici. `CultureInfo.InvariantCulture` zabezpečí desatinnú bodku vo výstupe.

Súvisiace lekcie

  • C# · Lekcia 7 · Pokročilá · Verzia: 3

Zdroje