Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Delegados Func com tuplo e acumulador e validação do tamanho

Um delegado indica se a conversão foi bem-sucedida, outro atualiza o acumulador e um tamanho fora do intervalo permitido provoca uma exceção.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

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)> é um delegado do espaço de nomes System. Recebe um argumento do tipo TSource e devolve um único valor: um tuplo do tipo de valor System.ValueTuple<bool,TResult>, não dois parâmetros out. Os nomes dos campos, como Success e Value, são opcionais; o resultado pode ser desconstruído com var (success, value). O significado do indicador faz parte do contrato do delegado: aqui, false indica que o valor deve ser ignorado e true permite utilizá-lo, mesmo que seja o valor predefinido do tipo.

Func<TAcc,T,TAcc> é outro tipo de delegado de System. Recebe o acumulador atual do tipo TAcc e um elemento do tipo T, e devolve o novo acumulador do tipo TAcc. O último argumento de tipo de Func indica o tipo devolvido. Em FoldPrefix, T é o tipo do resultado da conversão (TResult na primeira notação). O método parte de seed, percorre por ordem os primeiros size elementos e só atualiza o acumulador quando a conversão tem êxito. Os elementos descartados também contam para size.

FoldPrefix é um método de exemplo, não uma API do .NET. O tamanho válido vai de 0 a source.Count, inclusive. Com zero, devolve seed sem invocar nenhum dos delegados. Se size < 0 || size > source.Count, lança System.ArgumentOutOfRangeException antes de aceder a um elemento por índice ou invocar um delegado. O construtor com três argumentos recebe, por esta ordem, o nome do parâmetro (nameof(size)), o valor inválido (size) e uma mensagem que descreve o intervalo. O nome e o valor podem ser lidos através de ParamName e ActualValue.

Exemplos

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

Resultado

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

Exemplo de consola para C# 12 e .NET 8: o tamanho 3 dá 15 (10 + 2 + 3), porque `bad` é ignorado e `100` fica fora do prefixo. O tamanho 0 dá 10. O tamanho 5 é inválido para quatro elementos; o programa apresenta o nome do parâmetro e o respetivo valor, não a mensagem da exceção.

Lições relacionadas

  • C# · Lição 29 · Avançado · Versão: 3

Fontes