Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

System.Numerics.INumber<T> i statyczne T.Zero/CreateChecked

Użyj ograniczenia `INumber<T>`, aby wykonywać działania na różnych typach liczbowych, pobierać zero typu docelowego i konwertować wartości z kontrolą zakresu.

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

Składnia

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

Interfejs INumber<TSelf> z przestrzeni nazw System.Numerics opisuje porównywalne typy liczbowe. Ograniczenie where T : INumber<T> wymaga, aby T implementował ten interfejs dla samego siebie, np. int implementuje INumber<int>. Dzięki temu jedna metoda generyczna może używać operatorów takich jak + i < dla dwóch wartości typu T, bez osobnego przeciążenia dla każdego typu.

INumber<T> dziedziczy po INumberBase<T>, który deklaruje obie składowe statyczne. T.Zero to abstrakcyjna właściwość statyczna zwracająca zero typu T; od niej zacznij sumowanie zamiast używać literału 0 lub zakładać, że default(T) oznacza zero. T.CreateChecked<TOther>(value) to wirtualna metoda statyczna zwracająca docelowy typ T. Typ źródłowy TOther musi implementować INumberBase<TOther> i zwykle można go wywnioskować z argumentu. W kodzie generycznym używaj tych składowych przez ograniczony parametr T, nie przez instancję ani nazwę interfejsu.

Dla obsługiwanej konwersji na byte wartość 256 typu int wywołuje OverflowException: CreateSaturating zwróciłaby 255, a CreateTruncating zwróciłaby 0. Nieobsługiwana para typów może spowodować NotSupportedException. CreateChecked nie gwarantuje konwersji bez utraty precyzji; np. dla celu float może wynikiem być nieskończoność zamiast wyjątku. Metoda sprawdza konwersję, a nie późniejsze dodawanie przez +=.

Interfejsy matematyki generycznej wprowadzono w .NET 7, a mechanizm statycznych składowych abstrakcyjnych i wirtualnych w interfejsach — w C# 11. Przykład jest przeznaczony dla C# 12 i .NET 8.

Przykłady

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

Wynik

0
42
256
OverflowException

Pusta suma typu `byte` zwraca `0`; `40` i `2` dają `42`. Wartość `256` mieści się w `int`, ale nie w `byte`, więc ostatnie wywołanie wypisuje nazwę przechwyconego wyjątku.

Powiązane lekcje

  • C# · Lekcja 5 · Zaawansowany · Wersja: 3

Źródła