Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Delegáty Func s n-ticou a akumulátorom a kontrola veľkosti

Jeden delegát hlási úspech konverzie, druhý aktualizuje akumulátor a požadovaná veľkosť mimo povoleného rozsahu vyvolá výnimku.

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

Syntax

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 priestoru názvov System. Prijíma jeden argument typu TSource a vracia jedinú hodnotu: n-ticu hodnotového typu System.ValueTuple<bool,TResult>, nie dva parametre out. Názvy polí ako Success a Value sú voliteľné; výsledok možno rozložiť zápisom var (success, value). Význam príznaku je súčasťou kontraktu delegáta: false tu znamená hodnotu ignorovať a true umožňuje použiť ju, aj keď je predvolenou hodnotou daného typu.

Func<TAcc,T,TAcc> je iný typ delegáta zo System. Prijíma aktuálny akumulátor typu TAcc a prvok typu T a vracia nový akumulátor typu TAcc. Posledný typový argument Func určuje návratový typ. V FoldPrefix je T typ výsledku konverzie (TResult v prvom zápise). Metóda začína hodnotou seed, prechádza prvých size prvkov v poradí a aktualizuje akumulátor iba po úspešnej konverzii. Aj odmietnuté prvky sa započítavajú do size.

FoldPrefix je ukážková metóda, nie rozhranie API platformy .NET. Platná veľkosť je od 0 do source.Count vrátane. Pri nule metóda vráti seed bez zavolania ktoréhokoľvek delegáta. Ak size < 0 || size > source.Count, vyvolá System.ArgumentOutOfRangeException pred prístupom k prvkom pomocou indexu aj pred zavolaním delegátov. Konštruktor s tromi argumentmi prijíma v tomto poradí názov parametra (nameof(size)), neplatnú hodnotu (size) a správu opisujúcu rozsah. Názov a hodnotu možno prečítať z ParamName a ActualValue.

Prí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ýsledok

size 3: 15
size 0: 10
out of range: size=5

Konzolový príklad pre C# 12 a .NET 8: veľkosť 3 dá 15 (10 + 2 + 3), pretože `bad` sa preskočí a `100` je mimo prefixu. Veľkosť 0 dá 10. Veľkosť 5 nie je pre štyri prvky platná; program vypíše názov parametra a jeho hodnotu, nie text výnimky.

Súvisiace lekcie

  • C# · Lekcia 29 · Pokročilá · Verzia: 3

Zdroje