Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

INumber<T>: generični številski izračuni

INumber<T> omogoča pisanje ene generične metode za različne številske tipe. Omejitev izpostavi operatorje in podedovana člana T.Zero ter T.CreateChecked, s katerima lahko inicializirate akumulator in pretvorite vhodne vrednosti.

Različica: .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> v System.Numerics je vmesnik za generično matematiko. Omejitev where T : INumber<T> pomeni, da T implementira ta vmesnik zase. Izpostavi aritmetične operacije in primerjave, zato lahko ena metoda podpira na primer int in decimal. Vmesnik je bil uveden v .NET 7; dostop do statičnih članov vmesnika prek parametra tipa zahteva C# 11 ali novejšo različico. V projektu net10.0 z LangVersion=preview ta primer ne potrebuje funkcij v predogledni različici.

INumberBase<T>.Zero je podedovana lastnost static abstract, ki vrne ničlo tipa T; v generični metodi uporabite T.Zero. INumberBase<T>.CreateChecked je podedovana metoda static virtual, ki jo pokličete kot T.CreateChecked(value). Njen parameter tipa za izvorni tip izpolnjuje pogoj where TOther : INumberBase<TOther>. Pretvorba vrednosti zunaj obsega ciljnega tipa lahko sproži izjemo OverflowException, vendar se to ne zgodi vedno. Na primer, Half.CreateChecked(100000) vrne pozitivno neskončnost, namesto da bi sprožil izjemo. Nepodprt izvorni tip lahko povzroči izjemo NotSupportedException.

Primer sešteje vrednosti int, potem ko vsako pretvori v T. Prazno polje vrne T.Zero. Ime CreateChecked se nanaša na pretvorbo: samodejno ne vklopi preverjanja prekoračitve pri poznejšem seštevanju. Omejitev prav tako ne poenoti aritmetičnih pravil tipov — deljenje int na primer ostane celoštevilsko deljenje.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri