CKTIS / C#
Delegáti Action<T>, Func<T,TResult> a Predicate<T>
Ukládejte chování do proměnných a předávejte je jako argument: Action provede operaci, Func vrátí výsledek a Predicate ověří podmínku.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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);V C# 12 a .NET 8 jde o předdefinované generické typy delegátů v oboru názvů System. Ukázka syntaxe uvádí existující deklarace z knihovny; znovu je nedeklarujte. Typ zvolte podle toho, co potřebuje volající kód.
Action<T> přijímá jeden argument typu T a nevrací žádnou hodnotu (void), například při výpisu textu. Func<T,TResult> přijímá jeden argument typu T a vrací TResult; poslední typový parametr určuje typ výsledku. Predicate<T> přijímá jeden argument typu T a vrací bool: true, pokud prvek splňuje podmínku, jinak false.
Do proměnné typu delegáta přiřaďte kompatibilní lambda výraz (=>) nebo skupinu metod, například Console.WriteLine bez závorek. Cílový typ Action<string> pomáhá překladači vybrat přetížení s parametrem typu string. Přiřazení ani předání delegáta jako argumentu jeho kód nespustí; spustí ho až volání, například format(word).
Predicate<T> a Func<T,bool> mají stejnou signaturu volání, ale jde o různé typy. List<T>.FindAll očekává Predicate<T> a ihned vrací nový seznam. Enumerable.Where očekává Func<T,bool> nebo u přetížení s indexem Func<T,int,bool>; filtrování probíhá až při procházení posloupnosti. Proměnnou typu Predicate<T> nelze předat metodě Where přímo; použijte lambda výraz jako item => matches(item).
V deklaracích in T vyjadřuje kontravarianci vstupu a out TResult kovarianci výsledku. Tyto variantní převody platí pro referenční typy, ne pro int. Lambda výraz static nemůže nic zachytit; proměnná zachycená nestatickým lambda výrazem může přežít svůj blok. Přímé volání delegáta s hodnotou null vyvolá NullReferenceException; FindAll odmítne predikát null výjimkou ArgumentNullException.
Příklady
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));
}
}Výsledek
item: pear item: kiwi
`ReportMatches` přijímá tři delegáty. `FindAll` zavolá `matches` pro každé slovo a ponechá `pear` a `kiwi`. Poté `format` přidá předponu `item: ` a `report` vypíše každý výsledek na samostatný řádek.
Související lekce
- C# · Lekce 21 · Středně pokročilá · Verze: 2
Zdroje
- 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