Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

MidpointRounding: scegliere una regola di arrotondamento

MidpointRounding specifica una regola di arrotondamento. ToEven e AwayFromZero scelgono entrambi il risultato più vicino, ma trattano in modo diverso i valori che si trovano esattamente a metà tra due risultati possibili.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

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

MidpointRounding è un'enumerazione dello spazio dei nomi System, disponibile in .NET 10. Passala, ad esempio, a un overload come Math.Round(value, digits, mode), dove digits indica il numero di cifre decimali. È un'API di libreria, non una funzionalità della sintassi C# che richiede LangVersion=preview.

MidpointRounding.ToEven risolve un pareggio scegliendo il risultato la cui ultima cifra mantenuta è pari: con digits = 0, 2.5m diventa 2 e 3.5m diventa 4. Questo metodo si chiama arrotondamento bancario ed è il comportamento predefinito degli overload di Math.Round senza un parametro per la modalità di arrotondamento. MidpointRounding.AwayFromZero risolve un pareggio scegliendo il risultato più lontano da zero: 2.5m diventa 3 e -2.5m diventa -3.

Al di fuori dei pareggi, entrambe le modalità scelgono il risultato più vicino: 2.1m diventa 2 in entrambi i casi. Quindi AwayFromZero non aumenta sempre il valore assoluto. A una cifra decimale, 3.45m è a metà, mentre 3.451m non lo è. Le altre modalità — ToZero, ToNegativeInfinity e ToPositiveInfinity — arrotondano tutti i valori in una direzione specificata, non soltanto quelli a metà.

Il risultato dipende dal valore effettivamente memorizzato. La rappresentazione binaria di double può far sì che un valore apparentemente a metà in decimale non sia un pareggio. L'esempio usa valori letterali decimal con il suffisso m per rappresentare esattamente i valori mostrati e CultureInfo.InvariantCulture per fissare il formato dell'output.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti