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

CKTIS / C#

System.Numerics.INumber<T>: membros estáticos T.Zero e T.CreateChecked

Usa `INumber<T>` para escrever um só algoritmo para vários tipos numéricos, obter o zero do tipo de destino e converter valores com verificação do intervalo.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

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>, no espaço de nomes System.Numerics, define um contrato para tipos numéricos comparáveis. A restrição where T : INumber<T> exige que T implemente a interface usando o próprio tipo como argumento: por exemplo, int implementa INumber<int>. Assim, um único método genérico pode usar operadores como + e < com dois valores do tipo T, sem uma sobrecarga para cada tipo.

INumber<T> herda ambos os membros estáticos de INumberBase<T>. T.Zero é uma propriedade estática abstrata que devolve o zero do tipo T. Usa-a para iniciar uma soma em vez de recorrer ao literal 0 ou pressupor que default(T) significa zero. T.CreateChecked<TOther>(value) é um método estático virtual que devolve um valor do tipo de destino T. O tipo de origem TOther tem de implementar INumberBase<TOther> e normalmente pode ser inferido a partir do argumento. No código genérico, acede a estes membros através do parâmetro de tipo restringido T, não através de uma instância nem do nome da interface.

Na conversão suportada de int para byte, 256 provoca OverflowException: CreateSaturating devolveria 255 e CreateTruncating devolveria 0. Um par de tipos não suportado pode provocar NotSupportedException. CreateChecked não garante uma conversão sem perda; por exemplo, uma conversão para float pode devolver infinito em vez de lançar uma exceção. O método verifica a conversão, não a operação += que se segue.

As interfaces de matemática genérica foram introduzidas no .NET 7, e os membros de interface estáticos abstratos e virtuais no C# 11. O exemplo destina-se a C# 12 e .NET 8.

Exemplos

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

Resultado

0
42
256
OverflowException

A soma vazia do tipo `byte` devolve `0`; `40` e `2` dão `42`. O valor `256` cabe em `int`, mas não em `byte`, pelo que a última chamada escreve o nome da exceção capturada.

Lições relacionadas

  • C# · Lição 5 · Avançado · Versão: 3

Fontes