C++ 参考手册

位置：首页 > C++ 参考手册 >类型支持（基本类型、RTTI、类型特性） > std::is_copy_constructible, std::is_trivially_copy_constructible, std::is_nothrow_copy_constructible

std::is_copy_constructible, std::is_trivially_copy_constructible, std::is_nothrow_copy_constructible

定义于头文件 <type_traits>
template< class T >
struct is_copy_constructible;
 (1) (C++11 起)
template< class T >
struct is_trivially_copy_constructible;
 (2) (C++11 起)
template< class T >
struct is_nothrow_copy_constructible;
 (3) (C++11 起)

1) 若 T 不是可引用类型（即可为 cv 限定的 void 或带 cv-qualifier-seq 或 ref-qualifier 的函数类型），则提供等于 false 的成员常量 value 。否则，提供等于 std::is_constructible<T, const T&>::value 的成员常量 value 。

2) 同 (1) ，但使用 std::is_trivially_constructible<T, const T&> 。

3) 同 (1) ，但使用 std::is_nothrow_constructible<T, const T&> 。

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

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

添加此页面上描述的任何模板的特化的程序行为未定义。

辅助变量模板

template< class T >
inline constexpr bool is_copy_constructible_v = is_copy_constructible<T>::value;
 (C++17 起)
template< class T >
inline constexpr bool is_trivially_copy_constructible_v = is_trivially_copy_constructible<T>::value;
 (C++17 起)
template< class T >
inline constexpr bool is_nothrow_copy_constructible_v = is_nothrow_copy_constructible<T>::value;
 (C++17 起)

继承自 std::integral_constant

成员常量

value
[静态]
 若 T 可复制构造则为 true ，否则为 false
(公开静态成员常量)

成员函数

operator bool
 转换对象为 bool ，返回 value
(公开成员函数)
operator()
(C++14)
 返回 value
(公开成员函数)

成员类型

 
类型 定义
value_type bool
type std::integral_constant<bool, value>

可能的实现

template<class T>
struct is_copy_constructible :
    std::is_constructible<T, typename std::add_lvalue_reference<
        typename std::add_const<T>::type>::type> {};
 
template<class T>
struct is_trivially_copy_constructible :
    std::is_trivially_constructible<T, typename std::add_lvalue_reference<
        typename std::add_const<T>::type>::type> {};
 
template<class T>
struct is_nothrow_copy_constructible :
    std::is_nothrow_constructible<T, typename std::add_lvalue_reference<
        typename std::add_const<T>::type>::type> {};

注解

多数实现中， is_nothrow_copy_constructible 亦检查析构函数是否抛出，因为它等效于 noexcept(T(arg)) 。同样的情况应用于 is_trivially_copy_constructible ，它在这些实现中亦要求析构函数为平凡： GCC 漏洞 51452 、 LWG 问题 2116 。

示例

运行此代码
#include <iostream>
#include <type_traits>
 
struct Ex1 {
    std::string str; // 成员拥有非平凡复制构造函数
};
struct Ex2 {
    int n;
    Ex2(const Ex2&) = default; // 平凡且不抛出
};
 
int main() {
    std::cout << std::boolalpha << "Ex1 is copy-constructible? "
              << std::is_copy_constructible<Ex1>::value << '\n'
              << "Ex1 is trivially copy-constructible? "
              << std::is_trivially_copy_constructible<Ex1>::value << '\n'
              << "Ex2 is trivially copy-constructible? "
              << std::is_trivially_copy_constructible<Ex2>::value << '\n'
              << "Ex2 is nothrow copy-constructible? "
              << std::is_nothrow_copy_constructible<Ex2>::value << '\n';
}

输出： 

Ex1 is copy-constructible? true
Ex1 is trivially copy-constructible? false
Ex2 is trivially copy-constructible? true
Ex2 is nothrow copy-constructible? true

参阅

(C++11)(C++11)(C++11)
 检查类型是否带有针对特定实参的构造函数
(类模板)
(C++11)(C++11)(C++11)
 检查类型是否有默认构造函数
(类模板)
(C++11)(C++11)(C++11)
 检查类型是否能从右值引用构造
(类模板)