std::common_type

确定所有类型 T... 的共用类型，即所有 T... 都能隐式转换到的类型。若这种类型（根据后述规则确定）存在，则成员 type 指名该类型。否则，无成员 type 。

• 若 sizeof...(T) 为零，则无成员 type 。
• 若 sizeof...(T) 为一（即 T... 只含一个类型 T0 ），则成员 type 指名与 std::common_type<T0, T0>::type 相同的类型，若它存在；否则无成员 type 。
• 若 sizeof...(T) 为二（即 T... 含恰好二个成员 T1 与 T2 ），则

• 若应用 std::decay 到至少 T1 与 T2 中至少一个类型后产生相异类型，则成员 type 指名与 std::common_type<std::decay<T1>::type, std::decay<T2>::type>::type 相同的类型，若它存在；若不存在，则无成员 type 。
• 否则，若有对 std::common_type<T1, T2> 的用户定义特化，则使用该特化；
• 否则， 若 std::decay<decltype(false ? std::declval<T1>() : std::declval<T2>())>::type 是合法类型，则成员 type 代表该类型；

• 否则，无成员 type 。

• 若 sizeof...(T) 大于二（即 T... 由类型 T1, T2, R... 组成），则若 std::common_type<T1, T2>::type 存在，则成员 type 指代 std::common_type<std::common_type<T1, T2>::type, R...>::type ，若存在这种类型。其他所有情况下，无成员 type 。

参数包 T 中的类型应均为完整类型、（可为 cv 限定的） void ，或未知边界数组。否则行为未定义。

若上述模板的实例化直接或间接地依赖于不完整类型，并且如果假如使该类型完整，实例化就会产生不同的结果，则行为未定义。

成员类型

辅助类型

特化

用户可为类型 T1 与 T2 特化 common_type ，只要

• T1 与 T2 至少一个依赖于用户定义类型，且
• std::decay 对于 T1 和 T2 都是同等变换。

若这种特化拥有名为 type 的成员，则它必须是公开且无歧义的成员类型，并指名一个 T1 和 T2 都能显式转换到的，无 cv 限定且非引用的类型。而且， std::common_type<T1, T2>::type 与 std::common_type<T2, T1>::type 必须指代同一类型。

以违背这些规则的方式添加 common_type 特化的程序拥有未定义行为。

注意添加特化到来自 <type_traits> 的任何其他模板的行为是未定义的。

标准库已提供下列特化：

可能的实现

template <typename...>
using void_t = void; 
 
// 初等模板（用于零个类型）
template <class...>
struct common_type {};
 
//////// 一个类型
template <class T>
struct common_type<T> : common_type<T, T> {};
 
//////// 二个类型
template <class T1, class T2>
using cond_t = decltype(false ? std::declval<T1>() : std::declval<T2>());
 
template <class T1, class T2, class=void>
struct common_type_2_impl {};
 
template <class T1, class T2>
struct common_type_2_impl<T1, T2, void_t<cond_t<T1, T2>>> {
    using type = typename std::decay<cond_t<T1, T2>>::type;
};
 
template <class T1, class T2>
struct common_type<T1, T2> 
  : common_type_2_impl<typename std::decay<T1>::type, 
                       typename std::decay<T2>::type>
{};
 
//////// 3 个以上类型
template <class AlwaysVoid, class T1, class T2, class...R>
struct common_type_multi_impl {};
 
template <class T1, class T2, class...R>
struct common_type_multi_impl<
      void_t<typename common_type<T1, T2>::type>, T1, T2, R...>
  : common_type<typename common_type<T1, T2>::type, R...> {};
 
 
template <class T1, class T2, class... R>
struct common_type<T1, T2, R...>
  : common_type_multi_impl<void, T1, T2, R...> {};

注意

对于不是提升目标的算术类型，共用类型可视为如 T0() + T1() + ... + Tn() 的（可以为混合模式的）算术表达式的类型。

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

示例

#include <iostream>
#include <type_traits>
 
template <class T>
struct Number { T n; };
 
template <class T, class U>
Number<typename std::common_type<T, U>::type> operator+(const Number<T>& lhs,
                                                        const Number<U>& rhs) 
{
    return {lhs.n + rhs.n};
}
 
int main()
{
    Number<int> i1 = {1}, i2 = {2};
    Number<double> d1 = {2.3}, d2 = {3.5};
    std::cout << "i1i2: " << (i1 + i2).n << "\ni1d2: " << (i1 + d2).n << '\n'
              << "d1i2: " << (d1 + i2).n << "\nd1d2: " << (d1 + d2).n << '\n';
}

i1i2: 3
i1d2: 4.5
d1i2: 4.3
d1d2: 5.8