Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

INumber<T>: generički numerički izračuni

INumber<T> omogućuje pisanje jedne generičke metode za različite numeričke tipove. Ograničenje izlaže operatore i naslijeđene članove T.Zero i T.CreateChecked, kojima možete inicijalizirati akumulator i pretvoriti ulazne vrijednosti.

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

Sintaksa

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> u System.Numerics sučelje je za generičku matematiku. Ograničenje where T : INumber<T> znači da T implementira to sučelje za sebe. Ono izlaže aritmetičke operacije i usporedbe, pa jedna metoda može podržavati, primjerice, int i decimal. Sučelje je uvedeno u .NET 7; pristup statičkim članovima sučelja preko parametra tipa zahtijeva C# 11 ili noviji. U projektu net10.0 s LangVersion=preview ovaj primjer ne zahtijeva značajke u pretpregledu.

INumberBase<T>.Zero naslijeđeno je svojstvo static abstract koje vraća nulu tipa T; u generičkoj metodi koristi se T.Zero. INumberBase<T>.CreateChecked naslijeđena je metoda static virtual, koja se poziva kao T.CreateChecked(value). Njezin parametar tipa izvornog tipa zadovoljava uvjet where TOther : INumberBase<TOther>. Pretvorba vrijednosti izvan raspona odredišnog tipa može izazvati iznimku OverflowException, ali to se ne događa uvijek. Primjerice, Half.CreateChecked(100000) vraća pozitivnu beskonačnost umjesto da izazove iznimku. Nepodržani izvorni tip može uzrokovati iznimku NotSupportedException.

Primjer zbraja vrijednosti int nakon što svaku pretvori u T. Prazan niz daje T.Zero. Naziv CreateChecked odnosi se na pretvorbu: ne uključuje automatski provjeru prekoračenja pri naknadnom zbrajanju. Ograničenje također ne ujednačava aritmetička pravila tipova — primjerice, dijeljenje int i dalje je cjelobrojno dijeljenje.

Primjeri

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

Rezultat

10
10

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori