public member function
<functional>
template <class... ArgTypes>
typename result_of<type&(ArgTypes&&...)>::type
operator() (ArgTypes&&... args) const;
Access element (functional form)
Accesses the referred element.
The effect depends on the type referred by the reference_wrapper object (i.e., its class template parameter T, aliased as member type):
- If type is a function or a function object type, it is called forwarding the arguments to the function.
- If type is a pointer to a non-static member function, it is called using the first argument as the object on which the member is called (this may either be an object, a reference, or a pointer to it), and the remaining arguments are forwarded as arguments for the function.
- If type is a pointer to a non-static data member, it should be called with a single argument, and the function returns a reference to that member of its argument (the argument may either be an object, a reference, or a pointer to it).
Parameters
- args...
- Arguments for the invocation.
If type is a member pointer, the first argument shall be an object for which that member is defined (or a reference, or a pointer to it).
Return value
If the function performs a function call, it returns the return value of that function.
Otherwise, it returns a reference to accessed member.
type is a member type describing the referred type (it is an alias of the class template parameter, T).
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
|
// reference_wrapper::operator()
#include <iostream> // std::cout
#include <functional> // std::reference_wrapper, std::plus
struct AB {
int a,b;
int sum() {return a+b;}
};
int ten() {return 10;} // function
int main () {
std::plus<int> plus_ints; // function object
int AB::* p_a = &AB::a; // pointer to data member
int(AB::* p_sum)() = &AB::sum; // pointer to member function
// construct reference_wrappers using std::ref:
auto ref_ten = std::ref(ten); // function
auto ref_plus_ints = std::ref(plus_ints); // function object
auto ref_AB_sum = std::ref(p_sum); // pointer to member function
auto ref_AB_a = std::ref(p_a); // pointer to data member
AB ab {100,200};
// invocations:
std::cout << ref_ten() << '\n';
std::cout << ref_plus_ints(5,10) << '\n';
std::cout << ref_AB_sum(ab) << '\n';
std::cout << ref_AB_a( ab) << '\n';
std::cout << ref_AB_a(&ab) << '\n'; // (also ok with pointer)
return 0;
}
| |
Output:
Data races
Both the object and its referred element are accessed.
Exception safety
Provides the same level as the element accessed.