CKTIS / C#
INumber<T>: generieke numerieke berekeningen
Met INumber<T> schrijf je één generieke methode voor verschillende numerieke typen. De constraint biedt operators en de overgeërfde members T.Zero en T.CreateChecked, waarmee je een accumulator initialiseert en invoerwaarden converteert.
Versie: .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> in System.Numerics is een interface voor generieke wiskunde. De constraint where T : INumber<T> betekent dat T deze interface voor zichzelf implementeert. De interface biedt rekenkundige bewerkingen en vergelijkingen, zodat één methode bijvoorbeeld zowel int als decimal kan ondersteunen. De interface is geïntroduceerd in .NET 7; toegang tot statische interfacemembers via een typeparameter vereist C# 11 of hoger. In een net10.0-project met LangVersion=preview heeft dit voorbeeld geen previewfuncties nodig.
INumberBase<T>.Zero is een overgeërfde static abstract-eigenschap die nul van het type T retourneert; in een generieke methode gebruik je T.Zero. INumberBase<T>.CreateChecked is een overgeërfde static virtual-methode en wordt aangeroepen als T.CreateChecked(value). De typeparameter voor het brontype voldoet aan where TOther : INumberBase<TOther>. Bij het converteren van een waarde buiten het bereik van het doeltype kan een OverflowException optreden, maar dat gebeurt niet altijd. Zo geeft Half.CreateChecked(100000) positief oneindig terug in plaats van een uitzondering te veroorzaken. Een niet-ondersteund brontype kan een NotSupportedException veroorzaken.
Het voorbeeld telt int-waarden op nadat elke waarde naar T is geconverteerd. Een lege array levert T.Zero op. De naam CreateChecked heeft betrekking op de conversie: deze schakelt niet automatisch overflowcontrole in voor daaropvolgende optellingen. De constraint maakt de rekenregels van typen ook niet gelijk — deling van int blijft bijvoorbeeld gehele deling.
Voorbeelden
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;
}
Resultaat
10 10
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.