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

CKTIS / C#

System.Numerics.INumber<T> : membres statiques T.Zero et T.CreateChecked

Utilisez `INumber<T>` pour appliquer un même algorithme à plusieurs types numériques, obtenir le zéro du type cible et convertir des valeurs avec contrôle de plage.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

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>, dans l’espace de noms System.Numerics, définit un contrat pour les types numériques comparables. La contrainte where T : INumber<T> exige que T implémente l’interface en se donnant lui-même comme argument de type : par exemple, int implémente INumber<int>. Une seule méthode générique peut alors appliquer des opérateurs comme + et < à deux valeurs de type T, sans surcharge propre à chaque type.

INumber<T> hérite des deux membres statiques de INumberBase<T>. T.Zero est une propriété statique abstraite qui renvoie le zéro de type T. Utilisez-la pour initialiser une somme plutôt que de vous appuyer sur le littéral 0 ou de supposer que default(T) vaut zéro. T.CreateChecked<TOther>(value) est une méthode statique virtuelle qui renvoie une valeur du type cible T. Le type source TOther doit implémenter INumberBase<TOther> et peut généralement être déduit de l’argument. Dans du code générique, accédez à ces membres via le paramètre de type contraint T, et non via une instance ou le nom de l’interface.

Lors de la conversion prise en charge de int en byte, 256 déclenche une OverflowException : CreateSaturating renverrait 255 et CreateTruncating renverrait 0. Une paire de types non prise en charge peut entraîner une NotSupportedException. CreateChecked ne garantit pas une conversion sans perte : vers float, par exemple, elle peut renvoyer l’infini au lieu de lever une exception. La méthode contrôle la conversion, pas l’opération += qui suit.

Les interfaces de calcul générique ont été introduites dans .NET 7, et les membres d’interface statiques abstraits et virtuels dans C# 11. L’exemple cible C# 12 et .NET 8.

Exemples

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

Résultat

0
42
256
OverflowException

La somme vide de type `byte` vaut `0` ; `40` et `2` donnent `42`. La valeur `256` tient dans un `int`, mais pas dans un `byte`. Le dernier appel affiche donc le nom de l’exception interceptée.

Leçons associées

  • C# · Leçon 5 · Avancé · Version : 3

Sources