CKTIS / C#
INumber<T>: generische numerische Berechnungen
Mit INumber<T> kannst du eine generische Methode für verschiedene Zahlentypen schreiben. Die Einschränkung stellt Operatoren sowie die geerbten Member T.Zero und T.CreateChecked bereit, mit denen du einen Akkumulator initialisieren und Eingabewerte konvertieren kannst.
Version: .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 ist eine Schnittstelle für generische Mathematik. Die Einschränkung where T : INumber<T> bedeutet, dass T diese Schnittstelle für sich selbst implementiert. Sie stellt arithmetische Operationen und Vergleiche bereit, sodass eine Methode beispielsweise int und decimal unterstützen kann. Die Schnittstelle wurde mit .NET 7 eingeführt; für den Zugriff auf statische Schnittstellenmember über einen Typparameter ist C# 11 oder höher erforderlich. In einem net10.0-Projekt mit LangVersion=preview benötigt dieses Beispiel keine Preview-Funktionen.
INumberBase<T>.Zero ist eine geerbte static abstract-Eigenschaft, die null vom Typ T zurückgibt; in einer generischen Methode verwendest du T.Zero. INumberBase<T>.CreateChecked ist eine geerbte static virtual-Methode und wird als T.CreateChecked(value) aufgerufen. Ihr Typparameter für den Quelltyp erfüllt where TOther : INumberBase<TOther>. Die Konvertierung eines Werts außerhalb des Wertebereichs des Zieltyps kann eine OverflowException auslösen, muss es aber nicht. Beispielsweise gibt Half.CreateChecked(100000) positiv unendlich zurück, statt eine Ausnahme auszulösen. Ein nicht unterstützter Quelltyp kann eine NotSupportedException verursachen.
Das Beispiel summiert int-Werte, nachdem jeder einzelne in T konvertiert wurde. Ein leeres Array ergibt T.Zero. Der Name CreateChecked bezieht sich auf die Konvertierung: Er aktiviert nicht automatisch eine Überlaufprüfung für nachfolgende Additionen. Die Einschränkung vereinheitlicht auch nicht die Rechenregeln der Typen – beispielsweise bleibt die Division von int eine Ganzzahldivision.
Beispiele
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;
}
Ergebnis
10 10
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.