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