R operator()( Args... args ) const; | (since C++11) |
Invokes the stored callable function target with the parameters args
.
Effectively does INVOKE<R>(f, std::forward<Args>(args)...)
, where f
is the target object of *this
.
args | - | parameters to pass to the stored callable function target |
None if R
is void. Otherwise the return value of the invocation of the stored callable object.
Throws std::bad_function_call
if *this
does not store a callable function target, i.e. !*this == true
.
The following example shows how std::function
can be passed to other functions by value. Also, it shows how std::function
can store lambdas.
#include <functional> #include <iostream> void call(std::function<int()> f) // can be passed by value { std::cout << f() << '\n'; } int normal_function() { return 42; } int main() { int n = 1; std::function<int()> f = [&n](){ return n; }; call(f); n = 2; call(f); f = normal_function; call(f); }
Output:
1 2 42
(C++23) | invokes the target (public member function of std::move_only_function ) |
calls the stored function (public member function of std::reference_wrapper<T> ) |
|
(C++11) | the exception thrown when invoking an empty std::function (class) |
(C++17)(C++23) | invokes any Callable object with given arguments and possibility to specify return type (since C++23) (function template) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/functional/function/operator()