Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

System.Numerics.INumber<T>: miembros estáticos T.Zero y T.CreateChecked

Usa `INumber<T>` para escribir un solo algoritmo para varios tipos numéricos, obtener el cero del tipo de destino y convertir valores con comprobación de rango.

Versión: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxis

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>, del espacio de nombres System.Numerics, define un contrato para tipos numéricos comparables. La restricción where T : INumber<T> exige que T implemente la interfaz consigo mismo como argumento de tipo: por ejemplo, int implementa INumber<int>. Así, un único método genérico puede aplicar operadores como + y < a dos valores de tipo T, sin una sobrecarga por cada tipo.

INumber<T> hereda ambos miembros estáticos de INumberBase<T>. T.Zero es una propiedad estática abstracta que devuelve el cero de tipo T. Úsala para iniciar una suma en vez de recurrir al literal 0 o dar por hecho que default(T) es cero. T.CreateChecked<TOther>(value) es un método estático virtual que devuelve un valor del tipo de destino T. El tipo de origen TOther debe implementar INumberBase<TOther> y normalmente se puede inferir del argumento. En código genérico, accede a estos miembros mediante el parámetro de tipo restringido T, no mediante una instancia ni el nombre de la interfaz.

En la conversión admitida de int a byte, 256 provoca OverflowException: CreateSaturating devolvería 255 y CreateTruncating devolvería 0. Un par de tipos no admitido puede provocar NotSupportedException. CreateChecked no garantiza una conversión sin pérdida; por ejemplo, al convertir a float puede devolver infinito en vez de lanzar una excepción. El método comprueba la conversión, no la operación += posterior.

Las interfaces de matemáticas genéricas se introdujeron en .NET 7, y los miembros de interfaz estáticos abstractos y virtuales en C# 11. El ejemplo está dirigido a C# 12 y .NET 8.

Ejemplos

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

La suma vacía de tipo `byte` devuelve `0`; `40` y `2` dan `42`. El valor `256` cabe en `int`, pero no en `byte`, así que la última llamada imprime el nombre de la excepción capturada.

Lecciones relacionadas

  • C# · Lección 5 · Avanzado · Versión: 3

Fuentes