WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Func-Delegaten mit Tupel und Akkumulator sowie Größenprüfung

Ein Delegat meldet, ob eine Umwandlung gelungen ist, ein zweiter aktualisiert den Akkumulator. Eine Größe außerhalb des erlaubten Bereichs löst eine Ausnahme aus.

Version: 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)> ist ein Delegat aus System. Er nimmt ein Argument vom Typ TSource an und gibt einen einzigen Wert zurück: ein Tupel des Werttyps System.ValueTuple<bool,TResult>, nicht zwei out-Parameter. Feldnamen wie Success und Value sind optional. Mit var (success, value) lässt sich das Ergebnis dekonstruieren. Die Bedeutung des Flags gehört zum Vertrag des Delegaten: false heißt hier, den Wert zu ignorieren; bei true darf man ihn auch dann verwenden, wenn er dem Standardwert des Typs entspricht.

Func<TAcc,T,TAcc> ist ein anderer Delegattyp aus System. Er nimmt den aktuellen Akkumulator vom Typ TAcc und ein Element vom Typ T an und gibt den nächsten Akkumulator vom Typ TAcc zurück. Das letzte Typargument von Func ist der Rückgabetyp. In FoldPrefix ist T der Typ des Umwandlungsergebnisses (TResult in der ersten Schreibweise). Die Methode beginnt mit seed, verarbeitet die ersten size Elemente der Reihe nach und aktualisiert den Akkumulator nur nach erfolgreicher Umwandlung. Auch verworfene Elemente zählen zu size.

FoldPrefix ist eine Beispielmethode, keine .NET-API. Erlaubt sind Größen von 0 bis einschließlich source.Count. Bei null gibt die Methode seed zurück, ohne einen der Delegaten aufzurufen. Gilt size < 0 || size > source.Count, löst sie System.ArgumentOutOfRangeException aus, bevor sie auf Elemente zugreift oder Delegaten aufruft. Der Konstruktor mit drei Argumenten erhält in dieser Reihenfolge den Parameternamen (nameof(size)), den ungültigen Wert (size) und eine Meldung zum erlaubten Bereich. Name und Wert lassen sich über ParamName und ActualValue auslesen.

Beispiele

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

Ergebnis

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

Konsolenbeispiel für C# 12 und .NET 8: Größe 3 ergibt 15 (10 + 2 + 3), da `bad` übersprungen wird und `100` außerhalb des Anfangsabschnitts liegt. Größe 0 ergibt 10. Größe 5 ist bei vier Elementen ungültig; das Programm gibt Parametername und Wert aus, nicht die Ausnahmemeldung.

Zugehörige Lektionen

  • C# · Lektion 29 · Fortgeschritten · Version: 3

Quellen