База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Делегати Func с кортеж и акумулатор и проверка на размера

Единият делегат показва дали преобразуването е успешно, другият обновява акумулатора, а размер извън допустимия диапазон предизвиква изключение.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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)> е делегат от пространството от имена System. Приема един аргумент от тип TSource и връща една стойност: кортеж от стойностния тип System.ValueTuple<bool,TResult>, а не два параметъра out. Имена на полета като Success и Value не са задължителни; резултатът може да се деконструира с var (success, value). Значението на флага е част от договора на делегата: тук false означава стойността да се пренебрегне, а true позволява тя да се използва дори ако е стойността по подразбиране за типа.

Func<TAcc,T,TAcc> е друг тип делегат от System. Приема текущия акумулатор от тип TAcc и елемент от тип T, след което връща следващия акумулатор от тип TAcc. Последният типов аргумент на Func определя връщания тип. В FoldPrefix типът T е типът на резултата от преобразуването (TResult в първия запис). Методът започва от seed, обхожда последователно първите size елемента и обновява акумулатора само след успешно преобразуване. Отхвърлените елементи също се броят към size.

FoldPrefix е метод от примера, а не част от API на .NET. Допустимият размер е от 0 до source.Count включително. При нула методът връща seed, без да извиква делегатите. Ако size < 0 || size > source.Count, методът хвърля System.ArgumentOutOfRangeException, преди да достъпи елемент по индекс или да извика делегат. Конструкторът с три аргумента приема в този ред името на параметъра (nameof(size)), невалидната стойност (size) и съобщение, което описва диапазона. Името и стойността се четат чрез ParamName и ActualValue.

Примери

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

Резултат

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

Конзолен пример за C# 12 и .NET 8: размер 3 дава 15 (10 + 2 + 3), защото `bad` се пропуска, а `100` е извън префикса. Размер 0 дава 10. Размер 5 е невалиден при четири елемента; програмата извежда името на параметъра и неговата стойност, а не съобщението на изключението.

Свързани уроци

  • C# · Урок 29 · Напреднало · Версия: 3

Източници