CKTIS / C#
System.Numerics.INumber<T>: statische leden T.Zero en T.CreateChecked
Gebruik `INumber<T>` om één algoritme voor meerdere numerieke typen te schrijven, de nulwaarde van het doeltype op te halen en bij conversies het bereik te controleren.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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> in de naamruimte System.Numerics is een contract voor vergelijkbare numerieke typen. De beperking where T : INumber<T> vereist dat T de interface met zichzelf als typeargument implementeert: zo implementeert int de interface INumber<int>. Eén generieke methode kan dan operatoren als + en < toepassen op twee waarden van type T, zonder een aparte overload per type.
INumber<T> erft beide statische leden van INumberBase<T>. T.Zero is een statische abstracte eigenschap die de nulwaarde van type T retourneert. Gebruik die als beginwaarde van een som in plaats van de letterlijke waarde 0 te gebruiken of aan te nemen dat default(T) nul betekent. T.CreateChecked<TOther>(value) is een statische virtuele methode die een waarde van doeltype T retourneert. Het brontype TOther moet INumberBase<TOther> implementeren en is meestal af te leiden uit het argument. Benader deze leden in generieke code via de typeparameter T met die beperking, niet via een instantie of de interfacenaam.
Bij de ondersteunde conversie van int naar byte veroorzaakt 256 een OverflowException: CreateSaturating zou 255 retourneren en CreateTruncating zou 0 retourneren. Een niet-ondersteunde combinatie van typen kan een NotSupportedException veroorzaken. CreateChecked garandeert geen verliesvrije conversie: een conversie naar float kan bijvoorbeeld oneindig opleveren in plaats van een uitzondering. De methode controleert de conversie, niet de daaropvolgende bewerking +=.
De interfaces voor generieke wiskunde zijn geïntroduceerd in .NET 7, en statische abstracte en virtuele interfaceleden in C# 11. Het voorbeeld is bedoeld voor C# 12 en .NET 8.
Voorbeelden
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;
}Resultaat
0 42 256 OverflowException
De lege `byte`-som geeft `0`; `40` en `2` geven `42`. De waarde `256` past in `int`, maar niet in `byte`, dus de laatste aanroep toont de naam van de opgevangen uitzondering.
Gerelateerde lessen
- C# · Les 5 · Gevorderd · Versie: 3