KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Func-delegates met een tuple en accumulator, en lengtevalidatie

De ene delegate meldt of de conversie slaagt, de andere werkt de accumulator bij. Een lengte buiten het toegestane bereik leidt tot een uitzondering.

Versie: 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)> is een delegate uit de naamruimte System. Deze neemt één argument van het type TSource aan en retourneert één waarde: een tuple van het waardetype System.ValueTuple<bool,TResult>, niet twee out-parameters. Veldnamen zoals Success en Value zijn optioneel; je kunt het resultaat deconstrueren met var (success, value). De betekenis van de vlag hoort bij het contract van de delegate: hier betekent false dat je de waarde moet negeren, terwijl je die bij true mag gebruiken, ook als het de standaardwaarde van het type is.

Func<TAcc,T,TAcc> is een ander delegatetype uit System. Deze delegate neemt de huidige accumulator van het type TAcc en een element van het type T aan, en retourneert de volgende accumulator van het type TAcc. Het laatste typeargument van Func is het retourtype. In FoldPrefix is T het type van het conversieresultaat (TResult in de eerste notatie). De methode begint met seed, doorloopt de eerste size elementen op volgorde en werkt de accumulator alleen bij na een geslaagde conversie. Overgeslagen elementen tellen ook mee voor size.

FoldPrefix is een voorbeeldmethode, geen .NET-API. De geldige lengte loopt van 0 tot en met source.Count. Bij nul retourneert de methode seed zonder een delegate aan te roepen. Als size < 0 || size > source.Count, werpt de methode System.ArgumentOutOfRangeException op voordat die een element via een index benadert of een delegate aanroept. De constructor met drie argumenten krijgt achtereenvolgens de parameternaam (nameof(size)), de ongeldige waarde (size) en een bericht dat het bereik beschrijft. Naam en waarde lees je uit via ParamName en ActualValue.

Voorbeelden

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

Resultaat

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

Consolevoorbeeld voor C# 12 en .NET 8: lengte 3 levert 15 op (10 + 2 + 3), omdat `bad` wordt overgeslagen en `100` buiten het prefix valt. Lengte 0 levert 10 op. Lengte 5 is ongeldig bij vier elementen; het programma toont de parameternaam en de waarde, niet het uitzonderingsbericht.

Gerelateerde lessen

  • C# · Les 29 · Gevorderd · Versie: 3

Bronnen