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.