CKTIS / C#
Delegados Func con tupla y acumulador, y validación del tamaño
Un delegado indica si la conversión se realizó correctamente, otro actualiza el acumulador y un tamaño fuera del intervalo permitido provoca una excepción.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
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)> es un delegado del espacio de nombres System. Acepta un argumento de tipo TSource y devuelve un único valor: una tupla del tipo de valor System.ValueTuple<bool,TResult>, no dos parámetros out. Los nombres de campo como Success y Value son opcionales; puedes deconstruir el resultado con var (success, value). El significado del indicador forma parte del contrato del delegado: aquí false indica que se debe ignorar el valor y true permite usarlo aunque sea el valor predeterminado del tipo.
Func<TAcc,T,TAcc> es otro tipo de delegado de System. Recibe el acumulador actual de tipo TAcc y un elemento de tipo T, y devuelve el siguiente acumulador de tipo TAcc. El último argumento de tipo de Func es el tipo de retorno. En FoldPrefix, T es el tipo del resultado de la conversión (TResult en la primera notación). El método parte de seed, recorre en orden los primeros size elementos y actualiza el acumulador solo si la conversión se realiza correctamente. Los elementos descartados también cuentan para size.
FoldPrefix es un método de ejemplo, no una API de .NET. El tamaño válido va de 0 a source.Count, ambos incluidos. Con cero, devuelve seed sin invocar a ninguno de los delegados. Si size < 0 || size > source.Count, lanza System.ArgumentOutOfRangeException antes de acceder a un elemento por índice o invocar a un delegado. El constructor de tres argumentos recibe, en ese orden, el nombre del parámetro (nameof(size)), el valor no válido (size) y un mensaje que describe el intervalo. El nombre y el valor se consultan mediante ParamName y ActualValue.
Ejemplos
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
Ejemplo de consola para C# 12 y .NET 8: el tamaño 3 da 15 (10 + 2 + 3), porque se omite `bad` y `100` queda fuera del prefijo. El tamaño 0 da 10. El tamaño 5 no es válido para cuatro elementos; el programa imprime el nombre del parámetro y su valor, no el mensaje de la excepción.
Lecciones relacionadas
- C# · Lección 29 · Avanzado · Versión: 3