Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

INumber<T>: generyczne obliczenia liczbowe

INumber<T> pozwala pisać jedną metodę generyczną dla różnych typów liczbowych. Ograniczenie udostępnia operatory oraz odziedziczone składowe T.Zero i T.CreateChecked, dzięki którym można inicjalizować sumę i konwertować wartości wejściowe.

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

Składnia

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> z przestrzeni System.Numerics to interfejs generycznej matematyki. Ograniczenie where T : INumber<T> oznacza, że T implementuje ten interfejs dla samego siebie. Udostępnia ono arytmetykę i porównania, więc jedna metoda może obsługiwać na przykład int i decimal. Interfejs wprowadzono w .NET 7; dostęp do statycznych składowych interfejsów przez parametr typu wymaga C# 11 lub nowszego. W projekcie net10.0 z LangVersion=preview ten przykład nie wymaga funkcji eksperymentalnych.

INumberBase<T>.Zero to odziedziczona właściwość static abstract, zwracająca zero typu T; w metodzie generycznej używa się T.Zero. INumberBase<T>.CreateChecked to odziedziczona metoda static virtual, wywoływana jako T.CreateChecked(value). Jej parametr typu źródłowego spełnia where TOther : INumberBase<TOther>. Konwersja wartości spoza zakresu typu docelowego może zgłosić OverflowException, ale nie zawsze tak się dzieje. Na przykład Half.CreateChecked(100000) zwraca dodatnią nieskończoność zamiast zgłaszać wyjątek. Nieobsługiwany typ źródłowy może spowodować NotSupportedException.

Przykład sumuje wartości int po konwersji każdej z nich do T. Pusta tablica daje T.Zero. Nazwa CreateChecked dotyczy konwersji: nie włącza automatycznie kontroli przepełnienia późniejszego dodawania. Ograniczenie nie ujednolica też zasad arytmetyki typów — na przykład dzielenie int pozostaje całkowitoliczbowe.

Przykłady

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

Wynik

10
10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła