CKTIS / C#
System.Numerics.INumber<T>: statična člana T.Zero in T.CreateChecked
Z omejitvijo `INumber<T>` lahko napišeš en algoritem za več številskih tipov, pridobiš ničlo ciljnega tipa in pretvarjaš vrednosti s preverjanjem obsega.
Različica: 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 imenskega prostora System.Numerics določa pogodbo za primerljive številske tipe. Omejitev where T : INumber<T> zahteva, da T implementira vmesnik s samim seboj kot tipskim argumentom: na primer int implementira INumber<int>. Tako lahko ena generična metoda uporabi operatorje, kot sta + in <, na dveh vrednostih tipa T, brez ločene preobremenitve za vsak tip.
INumber<T> podeduje oba statična člana od INumberBase<T>. T.Zero je statična abstraktna lastnost, ki vrne ničlo tipa T. Uporabi jo kot začetno vrednost vsote, namesto da se zanašaš na literal 0 ali predpostavljaš, da default(T) pomeni ničlo. T.CreateChecked<TOther>(value) je statična virtualna metoda, ki vrne vrednost ciljnega tipa T. Izvorni tip TOther mora implementirati INumberBase<TOther> in ga je običajno mogoče izpeljati iz argumenta. V generični kodi do teh članov dostopaj prek omejenega tipskega parametra T, ne prek primerka ali imena vmesnika.
Pri podprti pretvorbi iz int v byte vrednost 256 sproži izjemo OverflowException: CreateSaturating bi vrnila 255, CreateTruncating pa 0. Nepodprt par tipov lahko sproži NotSupportedException. CreateChecked ne zagotavlja pretvorbe brez izgube: pri pretvorbi v float lahko na primer vrne neskončnost, namesto da sproži izjemo. Metoda preveri pretvorbo, ne poznejše operacije +=.
Vmesniki za generično matematiko so bili uvedeni v .NET 7, statični abstraktni in virtualni člani vmesnikov pa v C# 11. Primer je namenjen okolju C# 12 in .NET 8.
Primeri
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
Prazna vsota tipa `byte` vrne `0`; `40` in `2` dasta `42`. Vrednost `256` je v obsegu tipa `int`, ne pa tipa `byte`, zato zadnji klic izpiše ime ujete izjeme.
Povezane lekcije
- C# · Lekcija 5 · Napredna · Različica: 3