Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

System.Numerics.INumber<T>: statički članovi T.Zero i T.CreateChecked

Uz ograničenje `INumber<T>` možeš napisati jedan algoritam za više brojčanih tipova, dohvatiti nulu ciljnog tipa i pretvarati vrijednosti uz provjeru raspona.

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

Sintaksa

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> iz prostora imena System.Numerics definira ugovor za usporedive brojčane tipove. Ograničenje where T : INumber<T> zahtijeva da T implementira sučelje sa samim sobom kao argumentom tipa: primjerice, int implementira INumber<int>. Tako jedna generička metoda može primijeniti operatore poput + i < na dvije vrijednosti tipa T, bez zasebnog preopterećenja za svaki tip.

INumber<T> nasljeđuje oba statička člana iz INumberBase<T>. T.Zero je statičko apstraktno svojstvo koje vraća nulu tipa T. Upotrijebi ga kao početnu vrijednost zbroja umjesto da se oslanjaš na literal 0 ili pretpostavljaš da default(T) znači nulu. T.CreateChecked<TOther>(value) je statička virtualna metoda koja vraća vrijednost ciljnog tipa T. Izvorni tip TOther mora implementirati INumberBase<TOther> i obično se može izvesti iz argumenta. U generičkom kodu tim članovima pristupaj preko ograničenog parametra tipa T, a ne preko instance ili naziva sučelja.

Pri podržanoj pretvorbi iz int u byte vrijednost 256 izaziva iznimku OverflowException: CreateSaturating bi vratila 255, a CreateTruncating bi vratila 0. Nepodržani par tipova može izazvati NotSupportedException. CreateChecked ne jamči pretvorbu bez gubitka: pri pretvorbi u float može, primjerice, vratiti beskonačnost umjesto da izazove iznimku. Metoda provjerava pretvorbu, a ne naknadnu operaciju +=.

Sučelja za generičku matematiku uvedena su u .NET 7, a statički apstraktni i virtualni članovi sučelja u C# 11. Primjer je namijenjen za C# 12 i .NET 8.

Primjeri

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

Rezultat

0
42
256
OverflowException

Prazan zbroj tipa `byte` vraća `0`; `40` i `2` daju `42`. Vrijednost `256` stane u `int`, ali ne u `byte`, pa zadnji poziv ispisuje naziv uhvaćene iznimke.

Povezane lekcije

  • C# · Lekcija 5 · Napredno · Verzija: 3

Izvori