Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

System.Numerics.INumber<T>: statické členy T.Zero a T.CreateChecked

S obmedzením `INumber<T>` môžete napísať jeden algoritmus pre viaceré číselné typy, získať nulu cieľového typu a konvertovať hodnoty s kontrolou rozsahu.

Verzia: 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> z menného priestoru System.Numerics je kontrakt pre porovnateľné číselné typy. Obmedzenie where T : INumber<T> vyžaduje, aby T implementoval rozhranie so sebou samým ako typovým argumentom: napríklad int implementuje INumber<int>. Jedna generická metóda tak môže použiť operátory ako + a < na dve hodnoty typu T bez samostatného preťaženia pre každý typ.

INumber<T> dedí oba statické členy z INumberBase<T>. T.Zero je statická abstraktná vlastnosť, ktorá vracia nulu typu T. Použite ju ako počiatočnú hodnotu súčtu namiesto spoliehania sa na literál 0 alebo predpokladu, že default(T) znamená nulu. T.CreateChecked<TOther>(value) je statická virtuálna metóda, ktorá vracia hodnotu cieľového typu T. Zdrojový typ TOther musí implementovať INumberBase<TOther> a zvyčajne ho možno odvodiť z argumentu. V generickom kóde k týmto členom pristupujte cez obmedzený typový parameter T, nie cez inštanciu ani názov rozhrania.

Pri podporovanej konverzii z int na byte spôsobí 256 výnimku OverflowException: CreateSaturating by vrátila 255 a CreateTruncating by vrátila 0. Nepodporovaná dvojica typov môže spôsobiť NotSupportedException. CreateChecked nezaručuje bezstratovú konverziu: napríklad pri konverzii na float môže namiesto výnimky vrátiť nekonečno. Metóda kontroluje konverziu, nie následnú operáciu +=.

Rozhrania pre generickú matematiku boli zavedené v .NET 7 a statické abstraktné a virtuálne členy rozhraní v C# 11. Príklad je určený pre C# 12 a .NET 8.

Príklady

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

Výsledok

0
42
256
OverflowException

Prázdny súčet typu `byte` vráti `0`; `40` a `2` dajú `42`. Hodnota `256` sa zmestí do `int`, ale nie do `byte`, takže posledné volanie vypíše názov zachytenej výnimky.

Súvisiace lekcie

  • C# · Lekcia 5 · Pokročilá · Verzia: 3

Zdroje