CKTIS / C#
Delegados Action<T>, Func<T,TResult> e Predicate<T>
Guarda comportamento em variáveis e passa-o como argumento: Action executa uma operação, Func devolve um resultado e Predicate testa uma condição.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
public delegate void Action<in T>(T obj);
public delegate TResult Func<in T, out TResult>(T arg);
public delegate bool Predicate<in T>(T obj);Em C# 12 e .NET 8, estes tipos de delegado genéricos estão predefinidos no espaço de nomes System. A sintaxe mostra as declarações da biblioteca: não as voltes a declarar. Escolhe o tipo conforme o que o código que faz a chamada precisa.
Action<T> recebe um argumento do tipo T e não devolve nenhum valor (void), por exemplo ao escrever texto. Func<T,TResult> recebe um argumento do tipo T e devolve TResult; o último parâmetro de tipo indica o tipo do resultado. Predicate<T> recebe um argumento do tipo T e devolve um bool: true se o elemento satisfizer a condição e false caso contrário.
Atribui a uma variável de delegado uma expressão lambda compatível (=>) ou um grupo de métodos, como Console.WriteLine sem parênteses. O tipo de destino Action<string> ajuda o compilador a selecionar a sobrecarga que recebe um string. Atribuir ou passar um delegado como argumento não executa o seu código; invocá-lo, como em format(word), executa-o.
Predicate<T> e Func<T,bool> têm a mesma assinatura de chamada, mas são tipos distintos. List<T>.FindAll espera um Predicate<T> e devolve de imediato uma nova lista. Enumerable.Where espera um Func<T,bool> ou, na sobrecarga com índice, um Func<T,int,bool>; a filtragem ocorre quando se percorre a sequência. Não podes passar diretamente a Where uma variável do tipo Predicate<T>; usa uma lambda como item => matches(item).
Nas declarações, in T indica contravariância da entrada e out TResult indica covariância do resultado. Estas conversões de variância aplicam-se a tipos de referência, não a int. Uma lambda static não pode capturar nada; uma variável capturada por uma lambda não estática pode continuar a existir para além do seu bloco. Invocar diretamente um delegado null lança NullReferenceException; FindAll rejeita um predicado null com ArgumentNullException.
Exemplos
using System;
using System.Collections.Generic;
List<string> words = new() { "a", "pear", "kiwi" };
Predicate<string> matches = static word => word.Length >= 4;
Func<string, string> format = static word => $"item: {word}";
Action<string> report = Console.WriteLine;
ReportMatches(words, matches, format, report);
static void ReportMatches(
List<string> words,
Predicate<string> matches,
Func<string, string> format,
Action<string> report)
{
foreach (string word in words.FindAll(matches))
{
report(format(word));
}
}Resultado
item: pear item: kiwi
`ReportMatches` recebe três delegados. `FindAll` invoca `matches` para cada palavra e conserva `pear` e `kiwi`. Depois, `format` acrescenta o prefixo `item: ` e `report` escreve uma linha por palavra.
Lições relacionadas
- C# · Lição 21 · Intermédio · Versão: 2
Fontes
- Action<T> Delegate (System)
- Func<T,TResult> Delegate (System)
- Predicate<T> Delegate (System)
- List<T>.FindAll(Predicate<T>) Method (System.Collections.Generic)
- Enumerable.Where Method (System.Linq)
- Lambda expressions and anonymous functions
- Variance in Delegates (C#)
- Delegates — C# language specification
- Language versioning — C# reference