CKTIS / C#
INumber<T>: генерични числови изчисления
INumber<T> позволява да напишете един генеричен метод за различни числови типове. Ограничението предоставя оператори и наследените членове T.Zero и T.CreateChecked, с които можете да инициализирате акумулатор и да преобразувате входните стойности.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
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> в System.Numerics е интерфейс за генерична математика. Ограничението where T : INumber<T> означава, че T имплементира този интерфейс за себе си. То предоставя аритметични операции и сравнения, така че един метод може да поддържа например int и decimal. Интерфейсът е въведен в .NET 7; достъпът до статични членове на интерфейс чрез параметър за тип изисква C# 11 или по-нова версия. В проект net10.0 с LangVersion=preview този пример не изисква функции от предварителна версия.
INumberBase<T>.Zero е наследено свойство static abstract, което връща нула от тип T; в генеричен метод използвайте T.Zero. INumberBase<T>.CreateChecked е наследен метод static virtual, който се извиква като T.CreateChecked(value). Параметърът му за тип на източника удовлетворява where TOther : INumberBase<TOther>. Преобразуването на стойност извън диапазона на целевия тип може да хвърли изключение OverflowException, но това не се случва винаги. Например Half.CreateChecked(100000) връща положителна безкрайност, вместо да хвърли изключение. Неподдържан тип на източника може да доведе до изключение NotSupportedException.
Примерът сумира стойности int, след като преобразува всяка от тях към T. Празен масив дава T.Zero. Името CreateChecked се отнася до преобразуването: то не включва автоматично проверка за препълване при последващото събиране. Ограничението също не уеднаквява аритметичните правила на типовете — например делението на int остава целочислено деление.
Примери
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;
}
Резултат
10 10
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.