Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Delegaty Func z krotką i akumulatorem oraz walidacja rozmiaru

Delegat konwersji zwraca krotkę z flagą powodzenia, delegat agregacji aktualizuje akumulator, a rozmiar spoza zakresu powoduje wyjątek.

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

Składnia

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)> to delegat z przestrzeni nazw System. Przyjmuje jeden argument typu TSource i zwraca jedną wartość: krotkę typu wartościowego System.ValueTuple<bool,TResult>, a nie dwa parametry out. Nazwy pól, takie jak Success i Value, są opcjonalne; wynik można zdekonstruować jako var (success, value). Znaczenie flagi jest częścią umowy z delegatem: false oznacza tu, że wartość należy zignorować, a true pozwala użyć wartości, nawet jeśli jest domyślna dla danego typu.

Func<TAcc,T,TAcc> to inny typ delegata z System: przyjmuje bieżący akumulator typu TAcc i element typu T, a zwraca kolejny akumulator typu TAcc. Ostatni argument typu Func określa wynik. W FoldPrefix typ T to wynik konwersji (TResult z pierwszego zapisu). Metoda zaczyna od seed, przegląda pierwsze size elementów w kolejności i aktualizuje akumulator tylko po udanej konwersji. Odrzucone elementy również wliczają się do size.

FoldPrefix to metoda z przykładu, nie API platformy .NET. Dozwolony rozmiar to od 0 do source.Count włącznie. Zero zwraca seed bez wywoływania delegatów. Jeśli size < 0 || size > source.Count, metoda zgłasza System.ArgumentOutOfRangeException przed odczytem elementów i wywołaniem delegatów. Trzyargumentowy konstruktor przyjmuje kolejno nazwę parametru (nameof(size)), błędną wartość (size) i komunikat opisujący zakres. Nazwę i wartość można odczytać z ParamName i ActualValue.

Przykłady

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

Wynik

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

Przykład konsolowy dla C# 12 i .NET 8: rozmiar 3 daje 15 (10 + 2 + 3), bo `bad` zostaje pominięte, a `100` leży poza prefiksem. Rozmiar 0 daje 10. Rozmiar 5 jest nieprawidłowy dla czterech elementów; program wypisuje nazwę parametru i wartość, nie tekst wyjątku.

Powiązane lekcje

  • C# · Lekcja 29 · Zaawansowany · Wersja: 3

Źródła