CKTIS / C#
Les délégués Action<T>, Func<T,TResult> et Predicate<T>
Stockez un comportement dans une variable et passez-le en argument : Action effectue une opération, Func renvoie un résultat et Predicate teste une condition.
Version : 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);En C# 12 et .NET 8, ces types délégués génériques sont prédéfinis dans l’espace de noms System. La syntaxe présente les déclarations de la bibliothèque : ne les redéclarez pas. Choisissez le type adapté aux besoins du code appelant.
Action<T> prend un argument de type T et ne renvoie aucune valeur (void), par exemple pour afficher du texte. Func<T,TResult> prend un argument de type T et renvoie TResult ; le dernier paramètre de type indique le type du résultat. Predicate<T> prend un argument de type T et renvoie un bool : true si l’élément satisfait la condition, sinon false.
Affectez à une variable déléguée une expression lambda compatible (=>) ou un groupe de méthodes, comme Console.WriteLine sans parenthèses. Le type cible Action<string> aide le compilateur à sélectionner la surcharge qui prend un string. Affecter ou passer un délégué en argument n’exécute pas son code ; c’est l’appel, par exemple format(word), qui l’exécute.
Predicate<T> et Func<T,bool> ont la même signature d’appel, mais sont deux types distincts. List<T>.FindAll attend un Predicate<T> et renvoie immédiatement une nouvelle liste. Enumerable.Where attend un Func<T,bool> ou, dans la surcharge avec indice, un Func<T,int,bool> ; le filtrage a lieu lors du parcours de la séquence. Vous ne pouvez pas passer directement à Where une variable de type Predicate<T> ; utilisez une lambda comme item => matches(item).
Dans les déclarations, in T indique la contravariance de l’entrée et out TResult la covariance du résultat. Ces conversions de variance s’appliquent aux types référence, pas à int. Une lambda static ne peut rien capturer ; une variable capturée par une lambda non statique peut survivre à son bloc. L’appel direct d’un délégué null lève NullReferenceException ; FindAll rejette un prédicat null en levant ArgumentNullException.
Exemples
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));
}
}Résultat
item: pear item: kiwi
`ReportMatches` reçoit trois délégués. `FindAll` appelle `matches` pour chaque mot et conserve `pear` et `kiwi`. Ensuite, `format` ajoute le préfixe `item: ` et `report` affiche une ligne par mot.
Leçons associées
- C# · Leçon 21 · Intermédiaire · Version : 2
Sources
- 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