Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti