std::experimental::ranges::invoke
From cppreference.com
< cpp | experimental | ranges
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Experimental
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
General utilities library
Utility components
Function objects
Metaprogramming and type traits
Tagged pairs and tuples
Defined in header
<experimental/ranges/functional>
template< class F, class... Args >
std::result_of_t <F&&(Args&&...)> invoke( F&& f, Args&&... args );
(ranges TS)
std::result_of_t <F&&(Args&&...)> invoke( F&& f, Args&&... args );
Invoke the Callable object f with the parameters args, and return the result, as if by return INVOKE(std::forward <F>(f), std::forward <Args>(args)...);, where INVOKE(f, t1, t2, ..., tN) is defined as follows:
- if f is a pointer to member function of class
T
:
- If std::is_base_of <T, std::decay_t <decltype(t1)>>::value is true, then INVOKE(f, t1, t2, ..., tN) is equivalent to (t1.*f)(t2, ..., tN),
- otherwise, INVOKE(f, t1, t2, ..., tN) is equivalent to ((*t1).*f)(t2, ..., tN).
- otherwise, if N == 1 and f is a pointer to data member of class
T
:
- If std::is_base_of <T, std::decay_t <decltype(t1)>>::value is true, then INVOKE(f, t1) is equivalent to t1.*f,
- otherwise, then INVOKE(f, t1) is equivalent to (*t1).*f.
- otherwise, INVOKE(f, t1, t2, ..., tN) is equivalent to f(t1, t2, ..., tN) (that is, f is a FunctionObject).
[edit] Parameters
f
-
Callable object to be invoked
args
-
arguments to pass to f