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

CKTIS / C#

MidpointRounding — избор на правило за закръгляване

MidpointRounding задава правило за закръгляване. ToEven и AwayFromZero избират най-близкия резултат, но обработват по различен начин стойностите точно по средата между два възможни резултата.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

Math.Round(value, digits, MidpointRounding.ToEven)
Math.Round(value, digits, MidpointRounding.AwayFromZero)

MidpointRounding е изброим тип в пространството от имена System, наличен в .NET 10. Подайте го например на претоварен метод като Math.Round(value, digits, mode), където digits задава броя на десетичните позиции. Това е API на библиотека, а не функция на синтаксиса на C#, която изисква LangVersion=preview.

MidpointRounding.ToEven разрешава равенство, като избира резултата, чиято последна запазена цифра е четна: при digits = 0 2.5m дава 2, а 3.5m дава 4. Този метод се нарича банково закръгляване и е подразбиращото се поведение за претоварванията на Math.Round без параметър за режим на закръгляване. MidpointRounding.AwayFromZero разрешава равенство, като избира резултата, който е по-далеч от нулата: 2.5m дава 3, а -2.5m дава -3.

Извън случаите на равенство и двата режима избират най-близкия резултат: 2.1m дава 2 и в двата случая. Следователно AwayFromZero не увеличава винаги абсолютната стойност. При един знак след десетичната запетая 3.45m е точно по средата, но 3.451m не е. Другите режими — ToZero, ToNegativeInfinity и ToPositiveInfinity — закръгляват всички стойности в зададена посока, а не само тези по средата.

Резултатът зависи от действително съхранената стойност. Двоичното представяне на double може да доведе до това привидно десетична половина всъщност да не е равенство. Примерът използва литерали decimal с наставка m, за да представи точно показаните стойности, и CultureInfo.InvariantCulture, за да фиксира формата на изхода.

Примери

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

Резултат

value | ToEven | AwayFromZero
2.5 | 2 | 3
3.5 | 4 | 4
-2.5 | -2 | -3
2.1 | 2 | 2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници