CKTIS / C#
Delegáty Func s n-ticí a akumulátorem a kontrola velikosti
Jeden delegát hlásí úspěch převodu, druhý aktualizuje akumulátor a požadovaná velikost mimo povolený rozsah vyvolá výjimku.
Verze: 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)> je delegát z oboru názvů System. Přijímá jeden argument typu TSource a vrací jedinou hodnotu: n-tici hodnotového typu System.ValueTuple<bool,TResult>, nikoli dva parametry out. Názvy polí jako Success a Value jsou volitelné; výsledek lze rozložit zápisem var (success, value). Význam příznaku je součástí kontraktu delegáta: false zde znamená hodnotu ignorovat, zatímco true dovoluje hodnotu použít, i když je výchozí hodnotou daného typu.
Func<TAcc,T,TAcc> je jiný typ delegáta z System. Přijímá aktuální akumulátor typu TAcc a prvek typu T a vrací nový akumulátor typu TAcc. Poslední typový argument Func určuje návratový typ. V FoldPrefix je T typ výsledku převodu (TResult v prvním zápisu). Metoda začíná hodnotou seed, prochází prvních size prvků v pořadí a aktualizuje akumulátor jen po úspěšném převodu. Do size se počítají i odmítnuté prvky.
FoldPrefix je ukázková metoda, nikoli rozhraní API platformy .NET. Platná velikost je od 0 do source.Count včetně. Při nule metoda vrátí seed, aniž zavolá některý z delegátů. Pokud size < 0 || size > source.Count, vyvolá System.ArgumentOutOfRangeException před přístupem k prvkům pomocí indexu i před zavoláním delegátů. Konstruktor se třemi argumenty přijímá v tomto pořadí název parametru (nameof(size)), neplatnou hodnotu (size) a zprávu popisující rozsah. Název a hodnotu lze číst z ParamName a ActualValue.
Příklady
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;
}Výsledek
size 3: 15 size 0: 10 out of range: size=5
Konzolový příklad pro C# 12 a .NET 8: velikost 3 dává 15 (10 + 2 + 3), protože `bad` se přeskočí a `100` leží mimo prefix. Velikost 0 dává 10. Velikost 5 není pro čtyři prvky platná; program vypíše název parametru a jeho hodnotu, nikoli text výjimky.
Související lekce
- C# · Lekce 29 · Pokročilá · Verze: 3