KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen