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