std::function
De cppreference.com.
< cpp | utility | functional
| Défini dans l'entê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...
Sommaire |
[modifier] 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...)
|
[modifier] 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) | |
[modifier] 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) | |
[modifier] Classe d'aide
| spécialise std::uses_allocator (classe générique spécialisée) | |
[modifier] 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
[modifier] 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) |
