WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

System.Numerics.INumber<T>: statisches T.Zero und T.CreateChecked

Mit `INumber<T>` schreibst du einen Algorithmus für mehrere Zahlentypen, erhältst die Null des Zieltyps und konvertierst Werte mit Bereichsprüfung.

Version: 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> aus dem Namespace System.Numerics definiert einen Vertrag für vergleichbare Zahlentypen. Die Einschränkung where T : INumber<T> verlangt, dass T die Schnittstelle mit sich selbst als Typargument implementiert: int implementiert beispielsweise INumber<int>. So kann eine generische Methode Operatoren wie + und < auf zwei Werte vom Typ T anwenden, ohne eine eigene Überladung pro Typ zu benötigen.

INumber<T> erbt beide statischen Member von INumberBase<T>. T.Zero ist eine statische abstrakte Eigenschaft, die die Null vom Typ T liefert. Verwende sie als Startwert einer Summe, statt dich auf das Literal 0 zu verlassen oder anzunehmen, dass default(T) null bedeutet. T.CreateChecked<TOther>(value) ist eine statische virtuelle Methode, die einen Wert des Zieltyps T zurückgibt. Der Quelltyp TOther muss INumberBase<TOther> implementieren und kann meist aus dem Argument abgeleitet werden. Greife in generischem Code über den eingeschränkten Typparameter T auf diese Member zu, nicht über eine Instanz oder den Schnittstellennamen.

Bei der unterstützten Konvertierung von int nach byte löst 256 eine OverflowException aus: CreateSaturating würde 255 liefern, CreateTruncating dagegen 0. Ein nicht unterstütztes Typenpaar kann eine NotSupportedException auslösen. CreateChecked garantiert keine verlustfreie Konvertierung; bei einer Konvertierung nach float kann beispielsweise Unendlich statt einer Ausnahme herauskommen. Die Methode prüft die Konvertierung, nicht die anschließende Operation +=.

Die Schnittstellen für generische Mathematik wurden mit .NET 7 eingeführt, statische abstrakte und virtuelle Schnittstellenmember mit C# 11. Das Beispiel ist für C# 12 und .NET 8 ausgelegt.

Beispiele

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;
}

Ergebnis

0
42
256
OverflowException

Die leere `byte`-Summe liefert `0`; `40` und `2` ergeben `42`. Der Wert `256` passt in `int`, aber nicht in `byte`. Deshalb wird beim letzten Aufruf der Name der abgefangenen Ausnahme ausgegeben.

Zugehörige Lektionen

  • C# · Lektion 5 · Fortgeschritten · Version: 3

Quellen