CKTIS / C#
Délégués Func avec tuple et accumulateur, et validation de la taille
Un délégué indique si la conversion a réussi, un autre met à jour l’accumulateur, et une taille hors de l’intervalle autorisé déclenche une exception.
Version : C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
System.Func<TSource, (bool Success, TResult Value)> convert;
System.Func<TAcc, T, TAcc> accumulate;
if (size < 0 || size > source.Count)
throw new System.ArgumentOutOfRangeException(nameof(size), size, "Size must be between zero and the source count.");Func<TSource,(bool,TResult)> est un délégué de l’espace de noms System. Il prend un argument de type TSource et renvoie une seule valeur : un tuple de type valeur System.ValueTuple<bool,TResult>, et non deux paramètres out. Les noms de champs comme Success et Value sont facultatifs ; var (success, value) permet de déconstruire le résultat. Le sens de l’indicateur fait partie du contrat du délégué : ici, false demande d’ignorer la valeur et true permet de l’utiliser, même si c’est la valeur par défaut du type.
Func<TAcc,T,TAcc> est un autre type de délégué de System. Il prend l’accumulateur courant de type TAcc et un élément de type T, puis renvoie le nouvel accumulateur de type TAcc. Le dernier argument de type de Func est le type de retour. Dans FoldPrefix, T désigne le type du résultat de la conversion (TResult dans la première notation). La méthode part de seed, parcourt les size premiers éléments dans l’ordre et ne met à jour l’accumulateur qu’après une conversion réussie. Les éléments rejetés comptent tout de même dans size.
FoldPrefix est une méthode d’exemple, pas une API .NET. La taille doit être comprise entre 0 et source.Count, bornes incluses. Avec zéro, la méthode renvoie seed sans appeler les délégués. Si size < 0 || size > source.Count, elle lève System.ArgumentOutOfRangeException avant tout accès par indice ou appel de délégué. Le constructeur à trois arguments prend, dans l’ordre, le nom du paramètre (nameof(size)), la valeur non valide (size) et un message décrivant l’intervalle. Le nom et la valeur sont accessibles via ParamName et ActualValue.
Exemples
using System;
using System.Collections.Generic;
using System.Globalization;
string[] items = { "2", "bad", "3", "100" };
Func<string, (bool Success, int Value)> convert = text =>
{
bool success = int.TryParse(text, NumberStyles.Integer,
CultureInfo.InvariantCulture, out int value);
return (success, value);
};
Func<int, int, int> accumulate = (sum, value) => sum + value;
Console.WriteLine(FormattableString.Invariant($"size 3: {FoldPrefix(items, 3, 10, convert, accumulate)}"));
Console.WriteLine(FormattableString.Invariant($"size 0: {FoldPrefix(items, 0, 10, convert, accumulate)}"));
try
{
FoldPrefix(items, 5, 10, convert, accumulate);
}
catch (ArgumentOutOfRangeException ex)
{
Console.WriteLine(FormattableString.Invariant($"out of range: {ex.ParamName}={ex.ActualValue}"));
}
static TAcc FoldPrefix<TSource, T, TAcc>(
IReadOnlyList<TSource> source, int size, TAcc seed,
Func<TSource, (bool Success, T Value)> convert,
Func<TAcc, T, TAcc> accumulate)
{
ArgumentNullException.ThrowIfNull(source);
ArgumentNullException.ThrowIfNull(convert);
ArgumentNullException.ThrowIfNull(accumulate);
if (size < 0 || size > source.Count)
throw new ArgumentOutOfRangeException(nameof(size), size,
"Size must be between zero and the source count.");
TAcc acc = seed;
for (int i = 0; i < size; i++)
{
var (success, value) = convert(source[i]);
if (success)
acc = accumulate(acc, value);
}
return acc;
}Résultat
size 3: 15 size 0: 10 out of range: size=5
Exemple console pour C# 12 et .NET 8 : une taille de 3 donne 15 (10 + 2 + 3), car `bad` est ignoré et `100` est hors du préfixe. Une taille de 0 donne 10. Une taille de 5 n’est pas valide pour quatre éléments ; le programme affiche le nom du paramètre et sa valeur, pas le message de l’exception.
Leçons associées
- C# · Leçon 29 · Avancé · Version : 3