Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

INumber<T>: calcoli numerici generici

INumber<T> consente di scrivere un unico metodo generico per diversi tipi numerici. Il vincolo espone operatori e i membri ereditati T.Zero e T.CreateChecked, che permettono di inizializzare un accumulatore e convertire i valori di input.

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

Sintassi

static T SumAs<T>(int[] values) where T : INumber<T>
{
    T total = T.Zero;
    foreach (int value in values)
        total += T.CreateChecked(value);
    return total;
}

INumber<T> in System.Numerics è un'interfaccia per la matematica generica. Il vincolo where T : INumber<T> significa che T implementa questa interfaccia per sé stesso. Espone operazioni aritmetiche e confronti, consentendo a un solo metodo di supportare, per esempio, int e decimal. L'interfaccia è stata introdotta in .NET 7; per accedere ai membri statici di un'interfaccia tramite un parametro di tipo è necessario C# 11 o versione successiva. In un progetto net10.0 con LangVersion=preview, questo esempio non richiede funzionalità in anteprima.

INumberBase<T>.Zero è una proprietà ereditata static abstract che restituisce zero del tipo T; in un metodo generico si usa T.Zero. INumberBase<T>.CreateChecked è un metodo ereditato static virtual, chiamato come T.CreateChecked(value). Il suo parametro di tipo sorgente soddisfa where TOther : INumberBase<TOther>. La conversione di un valore fuori dall'intervallo del tipo di destinazione può generare un'eccezione OverflowException, ma non sempre accade. Per esempio, Half.CreateChecked(100000) restituisce infinito positivo anziché generare un'eccezione. Un tipo sorgente non supportato può causare un'eccezione NotSupportedException.

L'esempio somma valori int dopo aver convertito ciascuno in T. Un array vuoto restituisce T.Zero. Il nome CreateChecked si riferisce alla conversione: non attiva automaticamente il controllo dell'overflow per le addizioni successive. Il vincolo non uniforma neppure le regole aritmetiche dei tipi: per esempio, la divisione di int resta una divisione intera.

Esempi

using System;
using System.Globalization;
using System.Numerics;

int[] values = { 2, 3, 5 };
Console.WriteLine(SumAs<int>(values));
Console.WriteLine(SumAs<decimal>(values).ToString(CultureInfo.InvariantCulture));

static T SumAs<T>(int[] values) where T : INumber<T>
{
    T total = T.Zero;
    foreach (int value in values)
        total += T.CreateChecked(value);
    return total;
}

Risultato

10
10

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