Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

INumber<T> : calculs numériques génériques

INumber<T> permet d’écrire une seule méthode générique pour différents types numériques. Sa contrainte expose des opérateurs ainsi que les membres hérités T.Zero et T.CreateChecked, qui permettent d’initialiser un accumulateur et de convertir les valeurs d’entrée.

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

Syntaxe

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> dans System.Numerics est une interface de mathématiques génériques. La contrainte where T : INumber<T> signifie que T implémente cette interface pour lui-même. Elle expose des opérations arithmétiques et des comparaisons, ce qui permet à une même méthode de prendre en charge, par exemple, int et decimal. L’interface a été introduite dans .NET 7 ; l’accès aux membres statiques d’une interface via un paramètre de type nécessite C# 11 ou une version ultérieure. Dans un projet net10.0 avec LangVersion=preview, cet exemple ne nécessite aucune fonctionnalité en préversion.

INumberBase<T>.Zero est une propriété héritée static abstract qui renvoie zéro de type T ; dans une méthode générique, utilisez T.Zero. INumberBase<T>.CreateChecked est une méthode héritée static virtual, appelée sous la forme T.CreateChecked(value). Son paramètre de type source satisfait where TOther : INumberBase<TOther>. La conversion d’une valeur hors de la plage du type de destination peut lever une exception OverflowException, mais ce n’est pas systématique. Par exemple, Half.CreateChecked(100000) renvoie l’infini positif au lieu de lever une exception. Un type source non pris en charge peut provoquer une exception NotSupportedException.

L’exemple additionne des valeurs int après avoir converti chacune en T. Un tableau vide donne T.Zero. Le nom CreateChecked concerne la conversion : il n’active pas automatiquement la vérification des dépassements pour les additions suivantes. La contrainte n’uniformise pas non plus les règles arithmétiques des types — par exemple, la division de int reste une division entière.

Exemples

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

Résultat

10
10

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources