CKTIS / C#
INumber<T>: generické číselné výpočty
INumber<T> umožňuje napísať jednu generickú metódu pre rôzne číselné typy. Obmedzenie sprístupňuje operátory a zdedené členy T.Zero a T.CreateChecked, ktoré umožňujú inicializovať akumulátor a konvertovať vstupné hodnoty.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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> v System.Numerics je rozhranie pre generickú matematiku. Obmedzenie where T : INumber<T> znamená, že T implementuje toto rozhranie samo pre seba. Sprístupňuje aritmetické operácie a porovnávanie, takže jedna metóda môže podporovať napríklad int a decimal. Rozhranie bolo predstavené v .NET 7; prístup k statickým členom rozhrania cez parameter typu vyžaduje C# 11 alebo novší. V projekte net10.0 s LangVersion=preview tento príklad nevyžaduje funkcie vo verzii preview.
INumberBase<T>.Zero je zdedená vlastnosť static abstract, ktorá vracia nulu typu T; v generickej metóde použite T.Zero. INumberBase<T>.CreateChecked je zdedená metóda static virtual, ktorá sa volá ako T.CreateChecked(value). Jej parameter typu zdrojového typu spĺňa where TOther : INumberBase<TOther>. Konverzia hodnoty mimo rozsahu cieľového typu môže vyvolať výnimku OverflowException, no nie je to pravidlom. Napríklad Half.CreateChecked(100000) namiesto vyvolania výnimky vráti kladné nekonečno. Nepodporovaný zdrojový typ môže spôsobiť výnimku NotSupportedException.
Príklad sčítava hodnoty int po konverzii každej z nich na T. Prázdne pole vráti T.Zero. Názov CreateChecked sa týka konverzie: automaticky nezapína kontrolu pretečenia pri následnom sčítaní. Obmedzenie tiež nezjednocuje pravidlá aritmetiky jednotlivých typov — napríklad delenie int zostáva celočíselným delením.
Príklady
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;
}
Výsledok
10 10
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.