CKTIS / C#
System.Numerics.INumber<T>: membri statici T.Zero e T.CreateChecked
Usa `INumber<T>` per scrivere un solo algoritmo per più tipi numerici, ottenere lo zero del tipo di destinazione e convertire valori controllando l’intervallo.
Versione: C# 12 and .NET 8; later runtimes may add compatible features
Sintassi
using System.Numerics;
static T SumAs<T, TSource>(params TSource[] values)
where T : INumber<T>
where TSource : INumberBase<TSource>
{
T sum = T.Zero;
foreach (TSource value in values)
sum += T.CreateChecked<TSource>(value);
return sum;
}INumber<TSelf>, nello spazio dei nomi System.Numerics, definisce un contratto per i tipi numerici confrontabili. Il vincolo where T : INumber<T> richiede che T implementi l’interfaccia usando sé stesso come argomento di tipo: ad esempio, int implementa INumber<int>. Un solo metodo generico può quindi applicare operatori come + e < a due valori di tipo T, senza un overload per ogni tipo.
INumber<T> eredita entrambi i membri statici da INumberBase<T>. T.Zero è una proprietà statica astratta che restituisce lo zero di tipo T. Usala per inizializzare una somma, invece di affidarti al letterale 0 o di presumere che default(T) valga zero. T.CreateChecked<TOther>(value) è un metodo statico virtuale che restituisce un valore del tipo di destinazione T. Il tipo di origine TOther deve implementare INumberBase<TOther> e di solito si può dedurre dall’argomento. Nel codice generico, accedi a questi membri tramite il parametro di tipo vincolato T, non tramite un’istanza o il nome dell’interfaccia.
Nella conversione supportata da int a byte, 256 genera OverflowException: CreateSaturating restituirebbe 255 e CreateTruncating restituirebbe 0. Una coppia di tipi non supportata può generare NotSupportedException. CreateChecked non garantisce una conversione senza perdita: ad esempio, convertendo in float può restituire infinito invece di generare un’eccezione. Il metodo controlla la conversione, non la successiva operazione +=.
Le interfacce per la matematica generica sono state introdotte in .NET 7, mentre i membri di interfaccia statici astratti e virtuali sono stati introdotti in C# 11. L’esempio è destinato a C# 12 e .NET 8.
Esempi
using System;
using System.Globalization;
using System.Numerics;
Console.WriteLine(SumAs<byte, int>().ToString(CultureInfo.InvariantCulture));
Console.WriteLine(SumAs<byte, int>(40, 2).ToString(CultureInfo.InvariantCulture));
Console.WriteLine(SumAs<int, int>(256).ToString(CultureInfo.InvariantCulture));
try
{
_ = SumAs<byte, int>(256);
}
catch (OverflowException)
{
Console.WriteLine(nameof(OverflowException));
}
static T SumAs<T, TSource>(params TSource[] values)
where T : INumber<T>
where TSource : INumberBase<TSource>
{
T sum = T.Zero;
foreach (TSource value in values)
sum += T.CreateChecked<TSource>(value);
return sum;
}Risultato
0 42 256 OverflowException
La somma vuota di tipo `byte` restituisce `0`; `40` e `2` danno `42`. Il valore `256` rientra nell’intervallo di `int` ma non in quello di `byte`, quindi l’ultima chiamata stampa il nome dell’eccezione intercettata.
Lezioni correlate
- C# · Lezione 5 · Avanzato · Versione: 3