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

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