std::experimental::ranges::invoke

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

 

范围

概念

通用工具

迭代器

范围

算法

 

通用工具库

工具组件
swap	exchange
函数对象
invoke identity	equal_to not_equal_to	greater less	greater_equal less_equal
元编程与类型特性
is_swappable_withis_swappable	is_nothrow_swappable_withis_nothrow_swappable	common_reference common_type
有标签的 pair 与 tuple
TagSpecifier TaggedType	tagged 标签说明符	tagged_pair make_tagged_pair	tagged_tuple make_tagged_tuple

 

定义于头文件 <experimental/ranges/functional>
template < class F, class... Args > std::result_of_t<F&&(Args&&...)> invoke(F&& f, Args&&... args);		(范围 TS)

以参数 args 调用可调用 (Callable) 对象 f ，并返回结果，如同用 return INVOKE(std::forward<F>(f), std::forward<Args>(args)...); ，其中 INVOKE(f, t1, t2, ..., tN) 定义如下：

• 若 f 为类 T 的指向成员函数指针：

• 若 std::is_base_of<T, std::decay_t<decltype(t1)>>::value 为 true ，则 INVOKE(f, t1, t2, ..., tN) 等价于 (t1.*f)(t2, ..., tN)
• 否则， INVOKE(f, t1, t2, ..., tN) 等价于 ((*t1).*f)(t2, ..., tN) 。

• 否则，若 N == 1 且 f 为类 T 的指向数据成员指针：

• 若 std::is_base_of<T, std::decay_t<decltype(t1)>>::value 为 true ，则 INVOKE(f, t1) 等价于 t1.*f 。
• 否则， INVOKE(f, t1) 等价于 (*t1).*f 。

• 否则 INVOKE(f, t1, t2, ..., tN) 等价于 f(t1, t2, ..., tN) （即 f 是函数对象 (FunctionObject) ）。

参数

f	-	要调用的可调用 (Callable) 对象
args	-	传递给 f 的参数

参阅

invokeinvoke_r (C++17)(C++23)

以给定实参和可能指定的返回类型 (C++23 起)调用任意可调用 (Callable) 对象 (函数模板)