CKTIS / C#
Func<bool> e Action<int>: classificação de sinais e onAfterUnit
Use `Func<bool>` para avaliar regras de classificação de sinais e `Action<int>` para notificar o código chamador após o processamento de uma unidade.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
static void ProcessUnit(int unitIndex, Func<bool> isHigh, Func<bool> isLow, Action<int>? onAfterUnit = null)
{
string label = isHigh() ? "high" : isLow() ? "low" : "normal";
Console.WriteLine(label);
onAfterUnit?.Invoke(unitIndex);
}Func<bool> e Action<int> são tipos de delegado do espaço de nomes System. O primeiro não recebe argumentos e devolve um bool; o segundo recebe um int e não devolve nenhum valor (void). Se a regra tiver de receber explicitamente a leitura, use Func<int, bool>. O tipo não genérico Action não recebe argumentos.
Neste exemplo para C# 12 e .NET 8, ProcessUnit recebe dois delegados de classificação: isHigh e isLow. Primeiro, chama isHigh(). Se o resultado for true, escolhe high e não chama isLow(). Caso contrário, isLow() determina se a etiqueta é low ou normal. As lambdas capturam a variável reading criada nessa iteração, não uma cópia do seu valor. Manter um delegado pode prolongar o tempo de vida da variável capturada.
Depois de escrever a classificação, onAfterUnit?.Invoke(unitIndex) chama o callback opcional com o índice da unidade, contado a partir de zero, e não com o valor do sinal. Action<int>? admite null, = null permite omitir o argumento e ?. evita a chamada quando o delegado é null. ProcessUnit é um método do exemplo e onAfterUnit é o seu parâmetro, não um evento nem um membro da API do .NET.
A invocação dos delegados é síncrona. Se uma regra ou a operação de escrita lançar uma exceção, o callback não é chamado. Se o próprio callback lançar uma exceção, esta propaga-se para o código chamador. ?. não interceta exceções. Combinar delegados com += atribui à variável um delegado com a lista de invocação combinada, sem chamar nenhum método. Quando esse delegado é invocado, os métodos são executados por ordem; se um lançar uma exceção, os restantes não são chamados. Se a invocação terminar sem exceções, um Func<bool> combinado devolve apenas o resultado do último método, não uma combinação lógica dos resultados. Aceite delegados apenas de código de confiança: o tipo define a assinatura, mas não limita os efeitos secundários.
Exemplos
using System;
int[] readings = { 12, -3, 4 };
Action<int> onAfterUnit = static index =>
Console.WriteLine(FormattableString.Invariant($"after unit {index}"));
for (int i = 0; i < readings.Length; i++)
{
int reading = readings[i];
Func<bool> isHigh = () => reading >= 10;
Func<bool> isLow = () => reading < 0;
ProcessUnit(i, isHigh, isLow, onAfterUnit);
}
static void ProcessUnit(int unitIndex, Func<bool> isHigh, Func<bool> isLow,
Action<int>? onAfterUnit = null)
{
string label = isHigh() ? "high" : isLow() ? "low" : "normal";
Console.WriteLine(label);
onAfterUnit?.Invoke(unitIndex);
}Resultado
high after unit 0 low after unit 1 normal after unit 2
Para as leituras `12`, `-3` e `4`, as etiquetas esperadas são, respetivamente, `high`, `low` e `normal`. A cada etiqueta segue-se uma linha `after unit` com o índice da unidade.
Lições relacionadas
- C# · Lição 21 · Avançado · Versão: 3