std::invocable, std::regular_invocable

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

概念库

核心语言概念 same_as derived_from convertible_to common_reference_with common_with integral signed_integral unsigned_integral floating_point swappableswappable_with destructible constructible_from default_initializable move_constructible copy_constructible assignable_from

比较概念 equality_comparableequality_comparable_with totally_orderedtotally_ordered_with 对象概念 movable copyable semiregular regular 可调用概念 invocableregular_invocable predicate relation equivalence_relation strict_weak_order

 

定义于头文件 <concepts>
template< class F, class... Args > concept invocable =   requires(F&& f, Args&&... args) {     std::invoke(std::forward<F>(f), std::forward<Args>(args)...);       /* 不要求保持相等性 */   };		(C++20 起)
template< class F, class... Args > concept regular_invocable = std::invocable<F, Args...>;		(C++20 起)

invocable 概念指定能用函数模板 std::invoke 以参数集 Args... 调用可调用类型 F 。

regular_invocable 概念对 invocable 概念增加 invoke 必须保持相等性且不修改可调用对象或参数。

相等性保持

若表达式对给定的相等输入产生相等输出，则它保持相等性。

• 表达式的输入由其操作数组成。
• 表达式的输出由其结果和表达式所修改的所有操作数（若存在）组成。

在标准概念的规范中，操作数定义为仅包含下列内容的最大子表达式：

• 标识表达式，及
• 对 std::move 、 std::forward 与 std::declval 的调用。

每个操作数的 cv 限定与值类别，是通过假设每个模板类型形参代表一个 cv 无限定的非数组对象类型确定的。

进一步要求每个要求保持相等性的表达式都稳定：这种表达式带相同输入对象的二次求值必须拥有相等的输出，而无任何对这些输入对象的显式中间修改。

除非另外提醒，每个用于 requires 表达式中的表达式都要求保持相等性且稳定，而表达式的求值必须只修改其非常操作数。必须不修改常操作数。

注意

invocable 与 regular_invocable 间的区别是纯语义上的。

随机数生成器可满足 invocable 但不能满足 regular_invocable （除了搞笑的）。