std::disjunction
来自 cppreference.com
| 定义在头文件 <type_traits> 中 |
||
| template< class... B > struct disjunction; |
(自 C++17 起) | |
形成类型特征 B... 的 逻辑析取，有效地对特征序列执行逻辑 OR 操作。
特化 std::disjunction<B1, ..., BN> 有一个公共且明确的基类，它是
- 如果 sizeof...(B) == 0，则为 std::false_type；否则
- 在
B1, ..., BN中，第一个类型Bi满足 bool(Bi::value) == true，或者如果不存在这样的类型，则为BN。
基类的成员名称（除了 disjunction 和 operator= 之外）不会被隐藏，并且可以在 disjunction 中明确使用。
Disjunction 是短路运算：如果存在一个模板类型参数 Bi 满足 bool(Bi::value) != false，则实例化 disjunction<B1, ..., BN>::value 不需要实例化 j > i 的 Bj::value。
如果程序为 std::disjunction 或 std::disjunction_v 添加了特化，则行为未定义。
内容 |
[编辑] 模板参数
| B... | - | 每个模板参数 Bi，只要其 Bi::value 被实例化，都必须可用作基类并定义可转换为 bool 的成员 value |
[编辑] 辅助变量模板
| template< class... B > constexpr bool disjunction_v = disjunction<B...>::value; |
(自 C++17 起) | |
[编辑] 可能的实现
template<class...> struct disjunction : std::false_type {}; template<class B1> struct disjunction<B1> : B1 {}; template<class B1, class... Bn> struct disjunction<B1, Bn...> : std::conditional_t<bool(B1::value), B1, disjunction<Bn...>> {}; |
[编辑] 注意
disjunction 的特化不一定继承自 std::true_type 或 std::false_type：它只是继承自第一个 B，其 ::value 显式转换为 bool 为 true，或者当所有 B 都转换为 false 时，继承自最后一个 B。例如，std::disjunction<std::integral_constant<int, 2>, std::integral_constant<int, 4>>::value 是 2。
短路实例化使 disjunction 与 折叠表达式 区分开来：折叠表达式（如 (... || Bs::value)）会实例化 Bs 中的每个 B，而 std::disjunction_v<Bs...> 在可以确定值后停止实例化。这在后面类型实例化代价很高或在用错误类型实例化时可能导致严重错误时特别有用。
| 特性测试 宏 | 值 | Std | 特性 |
|---|---|---|---|
__cpp_lib_logical_traits |
201510L | (C++17) | 逻辑运算符类型特征 |
[编辑] 示例
运行此代码
#include <cstdint> #include <string> #include <type_traits> // values_equal<a, b, T>::value is true if and only if a == b. template<auto V1, decltype(V1) V2, typename T> struct values_equal : std::bool_constant<V1 == V2> { using type = T; }; // default_type<T>::value is always true template<typename T> struct default_type : std::true_type { using type = T; }; // Now we can use disjunction like a switch statement: template<int I> using int_of_size = typename std::disjunction< // values_equal<I, 1, std::int8_t>, // values_equal<I, 2, std::int16_t>, // values_equal<I, 4, std::int32_t>, // values_equal<I, 8, std::int64_t>, // default_type<void> // must be last! >::type; static_assert(sizeof(int_of_size<1>) == 1); static_assert(sizeof(int_of_size<2>) == 2); static_assert(sizeof(int_of_size<4>) == 4); static_assert(sizeof(int_of_size<8>) == 8); static_assert(std::is_same_v<int_of_size<13>, void>); // checking if Foo is constructible from double will cause a hard error struct Foo { template<class T> struct sfinae_unfriendly_check { static_assert(!std::is_same_v<T, double>); }; template<class T> Foo(T, sfinae_unfriendly_check<T> = {}); }; template<class... Ts> struct first_constructible { template<class T, class...Args> struct is_constructible_x : std::is_constructible<T, Args...> { using type = T; }; struct fallback { static constexpr bool value = true; using type = void; // type to return if nothing is found }; template<class... Args> using with = typename std::disjunction<is_constructible_x<Ts, Args...>..., fallback>::type; }; // OK, is_constructible<Foo, double> not instantiated static_assert(std::is_same_v<first_constructible<std::string, int, Foo>::with<double>, int>); static_assert(std::is_same_v<first_constructible<std::string, int>::with<>, std::string>); static_assert(std::is_same_v<first_constructible<std::string, int>::with<const char*>, std::string>); static_assert(std::is_same_v<first_constructible<std::string, int>::with<void*>, void>); int main() {}
[编辑] 另请参阅
| (C++17) |
逻辑 NOT 元函数 (类模板) |
| (C++17) |
可变参数逻辑与元函数 (类模板) |
