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

来自cppreference.com
 
C++
 
元编程库
类型特征
类型类别
(C++11)
(C++11)(DR*)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11) 
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++11)
(C++11)
(C++14)
(C++11)
(C++17)
(C++23)
(C++11)(C++26 弃用)
(C++11)
(C++11)
(C++11)(C++20 前*)
(C++11)(C++20 弃用)
(C++11)
(C++11)
(C++20)
(C++20)
(C++23)
(C++17)
类型特征常量
(C++11)(C++17)(C++11)(C++11)
元函数
(C++17)
(C++17)
(C++17)
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
类型变换
(C++11)(C++23 弃用)
(C++11)(C++23 弃用)
(C++11)
(C++20)
(C++11)(C++20 前*)(C++17)

(C++11)
(C++11)
(C++20)
(C++11)
(C++20)
(C++11)
(C++17)
编译时有理数算术
编译时整数序列
(C++14)
 
在标头 <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 限定符序列 或引用限定符 的函数类型），则提供等于 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 <string>
#include <type_traits>

struct S1
{
    std::string str; // 成员拥有非平凡复制构造函数
};
static_assert(std::is_copy_constructible_v<S1>);
static_assert(!std::is_trivially_copy_constructible_v<S1>);

struct S2
{
    int n;
    Ex2(const Ex2&) = default; // 平凡且不抛出
};
static_assert(std::is_trivially_copy_constructible_v<S2>);
static_assert(std::is_nothrow_copy_constructible_v<S2>);

struct S3
{
    S3(const S3&) = delete; // 显式弃置
};
static_assert(!std::is_copy_constructible_v<S3>);

struct S4
{
    S4(S4&) {}; // 无法绑定 const，因而不是可复制构造
};
static_assert(!std::is_copy_constructible_v<S4>);

int main() {}

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 2196 C++11 无法组成 const T& 时的行为不明确 此时产生的值是 false

参阅

(C++11)(C++11)(C++11)
 检查类型是否带有针对特定实参的构造函数
(类模板) [编辑]
(C++11)(C++11)(C++11)
 检查类型是否有默认构造函数
(类模板) [编辑]
(C++11)(C++11)(C++11)
 检查类型是否能从右值引用构造
(类模板) [编辑]
(C++20)
 指定能复制构造和移动构造一个类型的对象
(概念) [编辑]