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

CKTIS / C#

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

INumber<T> permite escribir un único método genérico para distintos tipos numéricos. Su restricción proporciona operadores y los miembros heredados T.Zero y T.CreateChecked, que permiten inicializar un acumulador y convertir los valores de entrada.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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> en System.Numerics es una interfaz de matemáticas genéricas. La restricción where T : INumber<T> significa que T implementa esta interfaz para sí mismo. Proporciona operaciones aritméticas y comparaciones, de modo que un método puede admitir, por ejemplo, int y decimal. La interfaz se introdujo en .NET 7; para acceder a miembros estáticos de una interfaz mediante un parámetro de tipo se requiere C# 11 o posterior. En un proyecto net10.0 con LangVersion=preview, este ejemplo no necesita características en vista previa.

INumberBase<T>.Zero es una propiedad heredada static abstract que devuelve cero del tipo T; dentro de un método genérico se usa T.Zero. INumberBase<T>.CreateChecked es un método heredado static virtual y se llama como T.CreateChecked(value). Su parámetro de tipo de origen cumple where TOther : INumberBase<TOther>. Convertir un valor fuera del rango del tipo de destino puede lanzar OverflowException, pero no siempre ocurre. Por ejemplo, Half.CreateChecked(100000) devuelve infinito positivo en vez de lanzar una excepción. Un tipo de origen no compatible puede causar NotSupportedException.

El ejemplo suma valores int después de convertir cada uno a T. Un array vacío da como resultado T.Zero. El nombre CreateChecked se refiere a la conversión: no activa automáticamente la comprobación de desbordamiento en las sumas posteriores. La restricción tampoco unifica las reglas aritméticas de los tipos; por ejemplo, la división de int sigue siendo división entera.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes