CKTIS / C#
System.Numerics.INumber<T>: statički članovi T.Zero i T.CreateChecked
Uz ograničenje `INumber<T>` možeš napisati jedan algoritam za više brojčanih tipova, dohvatiti nulu ciljnog tipa i pretvarati vrijednosti uz provjeru raspona.
Verzija: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
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> iz prostora imena System.Numerics definira ugovor za usporedive brojčane tipove. Ograničenje where T : INumber<T> zahtijeva da T implementira sučelje sa samim sobom kao argumentom tipa: primjerice, int implementira INumber<int>. Tako jedna generička metoda može primijeniti operatore poput + i < na dvije vrijednosti tipa T, bez zasebnog preopterećenja za svaki tip.
INumber<T> nasljeđuje oba statička člana iz INumberBase<T>. T.Zero je statičko apstraktno svojstvo koje vraća nulu tipa T. Upotrijebi ga kao početnu vrijednost zbroja umjesto da se oslanjaš na literal 0 ili pretpostavljaš da default(T) znači nulu. T.CreateChecked<TOther>(value) je statička virtualna metoda koja vraća vrijednost ciljnog tipa T. Izvorni tip TOther mora implementirati INumberBase<TOther> i obično se može izvesti iz argumenta. U generičkom kodu tim članovima pristupaj preko ograničenog parametra tipa T, a ne preko instance ili naziva sučelja.
Pri podržanoj pretvorbi iz int u byte vrijednost 256 izaziva iznimku OverflowException: CreateSaturating bi vratila 255, a CreateTruncating bi vratila 0. Nepodržani par tipova može izazvati NotSupportedException. CreateChecked ne jamči pretvorbu bez gubitka: pri pretvorbi u float može, primjerice, vratiti beskonačnost umjesto da izazove iznimku. Metoda provjerava pretvorbu, a ne naknadnu operaciju +=.
Sučelja za generičku matematiku uvedena su u .NET 7, a statički apstraktni i virtualni članovi sučelja u C# 11. Primjer je namijenjen za C# 12 i .NET 8.
Primjeri
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;
}Rezultat
0 42 256 OverflowException
Prazan zbroj tipa `byte` vraća `0`; `40` i `2` daju `42`. Vrijednost `256` stane u `int`, ali ne u `byte`, pa zadnji poziv ispisuje naziv uhvaćene iznimke.
Povezane lekcije
- C# · Lekcija 5 · Napredno · Verzija: 3