CKTIS / C#
Delegaty Action<T>, Func<T,TResult> i Predicate<T>
Zapisuj zachowanie w zmiennych i przekazuj je jako argumenty: Action wykonuje operację, Func zwraca wynik, a Predicate sprawdza warunek.
Wersja: C# 12 and .NET 8; later runtimes may add compatible features
Składnia
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);W C# 12 i .NET 8 są to gotowe generyczne typy delegatów z przestrzeni nazw System. Pokazana składnia opisuje istniejące deklaracje biblioteczne: nie deklaruj ich ponownie. Wybierz typ zgodny z tym, czego oczekuje kod wywołujący.
Action<T> przyjmuje jeden argument typu T i nie zwraca wartości (void), np. przy wypisywaniu tekstu. Func<T,TResult> przyjmuje jeden argument typu T i zwraca TResult; ostatni parametr typu oznacza wynik. Predicate<T> przyjmuje jeden argument typu T i zwraca bool: true, gdy element spełnia warunek, w przeciwnym razie false.
Do zmiennej delegata możesz przypisać zgodną lambdę (=>) lub grupę metod, np. Console.WriteLine bez nawiasów. Typ Action<string> pomaga kompilatorowi wybrać przeciążenie przyjmujące string. Przypisanie ani przekazanie delegata jako argumentu nie uruchamia kodu; robi to wywołanie, np. format(word).
Predicate<T> i Func<T,bool> mają tę samą sygnaturę wywołania, ale są różnymi typami. List<T>.FindAll oczekuje Predicate<T> i od razu zwraca nową listę. Enumerable.Where oczekuje Func<T,bool> lub, w przeciążeniu z indeksem, Func<T,int,bool>; filtrowanie odbywa się podczas iteracji. Istniejącej zmiennej Predicate<T> nie można przekazać bezpośrednio do Where; użyj lambdy pośredniczącej, np. item => matches(item).
W deklaracjach in T oznacza kontrawariancję wejścia, a out TResult — kowariancję wyniku. Te konwersje wariancyjne dotyczą typów referencyjnych, nie int. Lambda static niczego nie przechwytuje; w zwykłej lambdzie przechwycona zmienna może żyć dłużej niż jej blok. Bezpośrednie wywołanie delegata o wartości null zgłasza NullReferenceException; FindAll odrzuca predykat null wyjątkiem ArgumentNullException.
Przykłady
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));
}
}Wynik
item: pear item: kiwi
`ReportMatches` otrzymuje trzy delegaty. `FindAll` wywołuje `matches` dla każdego słowa i zachowuje `pear` oraz `kiwi`. Następnie `format` dodaje prefiks `item: `, a `report` wypisuje po jednym wierszu na słowo.
Powiązane lekcje
- C# · Lekcja 21 · Średniozaawansowany · Wersja: 2
Źródła
- 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