Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje