Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

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

S omezením `INumber<T>` můžete napsat jediný algoritmus pro více číselných typů, získat nulu cílového typu a převádět hodnoty s kontrolou rozsahu.

Verze: C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

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> ze jmenného prostoru System.Numerics je kontrakt pro porovnatelné číselné typy. Omezení where T : INumber<T> vyžaduje, aby T implementoval rozhraní se sebou samým jako typovým argumentem: například int implementuje INumber<int>. Jedna generická metoda tak může na dvě hodnoty typu T použít operátory jako + a <, aniž by potřebovala samostatné přetížení pro každý typ.

INumber<T> dědí oba statické členy z INumberBase<T>. T.Zero je statická abstraktní vlastnost, která vrací nulu typu T. Použijte ji jako výchozí hodnotu součtu, místo abyste se spoléhali na literál 0 nebo předpokládali, že default(T) znamená nulu. T.CreateChecked<TOther>(value) je statická virtuální metoda, která vrací hodnotu cílového typu T. Zdrojový typ TOther musí implementovat INumberBase<TOther> a obvykle jej lze odvodit z argumentu. V generickém kódu k těmto členům přistupujte přes omezený typový parametr T, nikoli přes instanci nebo název rozhraní.

Při podporovaném převodu z int na byte vyvolá 256 výjimku OverflowException: CreateSaturating by vrátila 255 a CreateTruncating by vrátila 0. Nepodporovaná dvojice typů může vyvolat NotSupportedException. CreateChecked nezaručuje bezeztrátový převod: například převod na float může místo výjimky vrátit nekonečno. Metoda kontroluje převod, nikoli následnou operaci +=.

Rozhraní pro generickou matematiku byla zavedena v .NET 7 a statické abstraktní a virtuální členy rozhraní v C# 11. Příklad cílí na C# 12 a .NET 8.

Pří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ýsledek

0
42
256
OverflowException

Prázdný součet typu `byte` vrátí `0`; `40` a `2` dají `42`. Hodnota `256` se vejde do `int`, ale ne do `byte`, takže poslední volání vypíše název zachycené výjimky.

Související lekce

  • C# · Lekce 5 · Pokročilá · Verze: 3

Zdroje