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

CKTIS / C#

INumber<T>: generické číselné výpočty

INumber<T> umožňuje napsat jednu generickou metodu pro různé číselné typy. Omezení zpřístupňuje operátory a zděděné členy T.Zero a T.CreateChecked, které slouží k inicializaci akumulátoru a převodu vstupních hodnot.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

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> v System.Numerics je rozhraní pro generickou matematiku. Omezení where T : INumber<T> znamená, že T implementuje toto rozhraní samo pro sebe. Zpřístupňuje aritmetické operace a porovnávání, takže jedna metoda může podporovat například int a decimal. Rozhraní bylo představeno v .NET 7; přístup ke statickým členům rozhraní prostřednictvím parametru typu vyžaduje C# 11 nebo novější. V projektu net10.0 s LangVersion=preview tento příklad nevyžaduje žádné funkce ve verzi preview.

INumberBase<T>.Zero je zděděná vlastnost static abstract, která vrací nulu typu T; v generické metodě použijte T.Zero. INumberBase<T>.CreateChecked je zděděná metoda static virtual, která se volá jako T.CreateChecked(value). Její parametr typu zdrojového typu splňuje where TOther : INumberBase<TOther>. Převod hodnoty mimo rozsah cílového typu může vyvolat výjimku OverflowException, ale ne vždy k tomu dojde. Například Half.CreateChecked(100000) místo vyvolání výjimky vrátí kladné nekonečno. Nepodporovaný zdrojový typ může způsobit výjimku NotSupportedException.

Příklad sčítá hodnoty int poté, co každou z nich převede na T. Prázdné pole vrátí T.Zero. Název CreateChecked se vztahuje k převodu: automaticky nezapíná kontrolu přetečení při následném sčítání. Omezení také nesjednocuje pravidla aritmetiky jednotlivých typů — například dělení int zůstává celočíselným dělením.

Příklady

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

Výsledek

10
10

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje