Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

INumber<T>: cálculos numéricos genéricos

INumber<T> permite escrever um único método genérico para diferentes tipos numéricos. A restrição disponibiliza operadores e os membros herdados T.Zero e T.CreateChecked, que permitem inicializar um acumulador e converter os valores de entrada.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

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> em System.Numerics é uma interface de matemática genérica. A restrição where T : INumber<T> significa que T implementa esta interface para si próprio. Disponibiliza operações aritméticas e comparações, permitindo que um método suporte, por exemplo, int e decimal. A interface foi introduzida no .NET 7; o acesso a membros estáticos de interfaces através de um parâmetro de tipo requer C# 11 ou posterior. Num projeto net10.0 com LangVersion=preview, este exemplo não precisa de funcionalidades de pré-visualização.

INumberBase<T>.Zero é uma propriedade herdada static abstract que devolve zero do tipo T; num método genérico, utiliza-se T.Zero. INumberBase<T>.CreateChecked é um método herdado static virtual, chamado como T.CreateChecked(value). O respetivo parâmetro de tipo de origem satisfaz where TOther : INumberBase<TOther>. A conversão de um valor fora do intervalo do tipo de destino pode lançar a exceção OverflowException, mas isso nem sempre acontece. Por exemplo, Half.CreateChecked(100000) devolve infinito positivo em vez de lançar uma exceção. Um tipo de origem não suportado pode provocar a exceção NotSupportedException.

O exemplo soma valores int depois de converter cada um para T. Um array vazio resulta em T.Zero. O nome CreateChecked diz respeito à conversão: não ativa automaticamente a verificação de overflow para as adições seguintes. A restrição também não uniformiza as regras aritméticas dos tipos — por exemplo, a divisão de int continua a ser uma divisão inteira.

Exemplos

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

Resultado

10
10

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes