База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

MidpointRounding.AwayFromZero с decimal.Round

Закръгляйте до най-близката стойност, а само при точно равни разстояния избирайте стойността с по-голяма абсолютна стойност.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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

В C# 12 и .NET 8 извикването decimal.Round(d, decimals, MidpointRounding.AwayFromZero) връща decimal, името в C# за System.Decimal. AwayFromZero е член на изброимия тип System.MidpointRounding и се подава на статичния метод като аргумент mode. Суфиксът m обозначава литерал от тип decimal, а не double.

Методът избира най-близката стойност с указания брой знаци след десетичния разделител. Само когато двете възможности са точно на еднакво разстояние, AwayFromZero избира тази с по-голяма абсолютна стойност: до един знак 2.25m става 2.3m, а -2.25m става -2.3m. Извън точната среда 2.24m става 2.2m. Правилото по подразбиране ToEven в decimal.Round(d, decimals) при равни разстояния избира резултата с четна последна запазена цифра. За разлика от него насоченият режим ToZero закръгля към нулата и извън случаите на равни разстояния.

decimals указва броя знаци след десетичния разделител, от 0 до 28 включително. decimal.Round(d, mode) закръгля до цяло число, но продължава да връща decimal. При претоварения метод с три аргумента decimals извън диапазона предизвиква ArgumentOutOfRangeException, а недефинирана стойност за mode предизвиква ArgumentException.

Примери

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

Резултат

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

Сравнете колоните: режимите се различават само в двата реда, в които входната стойност е точно по средата. `CultureInfo.InvariantCulture` осигурява десетична точка в изхода.

Свързани уроци

  • C# · Урок 7 · Напреднало · Версия: 3

Източници