std::function
De cppreference.com
<tbody>
</tbody>
| Déclaré dans l'en-tête <functional>
|
||
template< class > class function; /* undefined */ |
(depuis C++11) | |
template< class R, class... Args > class function<R(Args...)> |
(depuis C++11) | |
Le template de classe std::function est un adaptateur générique de fonction. En d'autres termes, une instance de std::function permet de manipuler une cible appelable (i.e. pour laquelle operator() est défini) , par exemple : une lambda (fonction anonyme), un bind (application partielle de fonction), un foncteur (objet-fonction), une fonction...
Types membres
| Type | Définition |
result_type
|
R
|
argument_type
|
le type du paramètre de fonction, si la fonction admet un seul paramètre (spécifié dans Args...)
|
first_argument_type
|
le type du premier paramètre de fonction, si la fonction admet deux paramètres (spécifiés dans Args...)
|
second_argument_type
|
le type du second paramètre de fonction, si la fonction admet deux paramètres (spécifiés dans Args...)
|
Fonctions membres
| construit une instance de std::function (fonction membre publique) | |
| détruit une instance de std::function (fonction membre publique) | |
| affecte un contenu à une instance de std::function (fonction membre publique) | |
| permute le contenu de deux instances de std::function (fonction membre publique) | |
| assigne une nouvelle instanciation (nouvelle cible) (fonction membre publique) | |
| vérifie si la cible est valide (fonction membre publique) | |
| appelle/évalue la cible (fonction membre publique) | |
Access à la cible | |
retourne le typeid de la cible stockée par l'instance (fonction membre publique) | |
| retourne un pointeur vers la cible stockée par l'instance (fonction membre publique) | |
Fonctions non-membres
(C++11) |
permet de spécialiser l'algorithme std::swap (fonction générique) |
| comparent deux instances de std::function (fonction générique) | |
Classe d'aide
| spécialise std::uses_allocator (classe générique spécialisée) | |
Exemple
#include <functional>
#include <iostream>
struct Foo {
Foo(int num) : num_(num) {}
void print_add(int i) const { std::cout << num_+i << '\n'; }
int num_;
};
void print_num(int i)
{
std::cout << i << '\n';
}
int main()
{
// store a free function
std::function<void(int)> f_display = print_num;
f_display(-9);
// store a lambda
std::function<void()> f_display_42 = []() { print_num(42); };
f_display_42();
// store the result of a call to std::bind
std::function<void()> f_display_31337 = std::bind(print_num, 31337);
f_display_31337();
// store a call to a member function
std::function<void(const Foo&, int)> f_add_display = &Foo::print_add;
Foo foo(314159);
f_add_display(foo, 1);
}
Résultat :
-9
42
31337
314160
Voir aussi
(C++11) |
exception levée si operator() est appelé sur un objet qui n'est pas un foncteur (classe) |
(C++11) |
crée un foncteur permettant d'accéder à un membre de classe donné; le foncteur prend alors en paramètre une instance de la classe (fonction générique) |