CKTIS / C#
System.Numerics.INumber<T>: статичните членове T.Zero и T.CreateChecked
Използвай `INumber<T>`, за да напишеш един алгоритъм за няколко числови типа, да получиш нулата на целевия тип и да преобразуваш стойности с проверка на диапазона.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
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> от пространството от имена System.Numerics определя договор за сравними числови типове. Ограничението where T : INumber<T> изисква T да реализира интерфейса със самия себе си като типов аргумент: например int реализира INumber<int>. Така един обобщен метод може да прилага оператори като + и < върху две стойности от тип T, без отделно претоварване за всеки тип.
INumber<T> наследява и двата статични члена от INumberBase<T>. T.Zero е статично абстрактно свойство, което връща нулата от тип T. Използвай го като начална стойност на сума, вместо да разчиташ на литерала 0 или да приемаш, че default(T) означава нула. T.CreateChecked<TOther>(value) е статичен виртуален метод, който връща стойност от целевия тип T. Типът на източника TOther трябва да реализира INumberBase<TOther> и обикновено може да се изведе от аргумента. В обобщен код достъпвай тези членове чрез ограничения типов параметър T, а не чрез екземпляр или името на интерфейса.
При поддържаното преобразуване от int към byte стойността 256 предизвиква OverflowException: CreateSaturating би върнал 255, а CreateTruncating би върнал 0. Неподдържана двойка типове може да предизвика NotSupportedException. CreateChecked не гарантира преобразуване без загуба: например преобразуването към float може да върне безкрайност, вместо да предизвика изключение. Методът проверява преобразуването, а не последващата операция +=.
Интерфейсите за обобщена математика са въведени в .NET 7, а статичните абстрактни и виртуални членове на интерфейси — в C# 11. Примерът е предназначен за C# 12 и .NET 8.
Примери
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;
}Резултат
0 42 256 OverflowException
Празната сума от тип `byte` връща `0`; `40` и `2` дават `42`. Стойността `256` се побира в `int`, но не и в `byte`, затова последното извикване отпечатва името на прихванатото изключение.
Свързани уроци
- C# · Урок 5 · Напреднало · Версия: 3