std::is_trivially_copyable

< cpp‎ | types
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
类型支持
基本类型
基础类型
定宽整数类型 (C++11)
数值极限
C 数值极限接口
运行时类型信息
类型特性
类型类别
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
is_trivially_copyable
(C++11)
(C++11)(C++20 前)
(C++11)(C++20 中弃用)
(C++11)
类型特性常量
元函数
(C++17)
常量求值语境
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)
(C++11)
(C++17)
(C++11)(C++20 前)(C++17)
 
定义于头文件 <type_traits>
template< class T >
struct is_trivially_copyable;
(C++11 起)

T可平凡复制 (TriviallyCopyable) 类型,则提供等于 true 的成员常量 value 。对于任何其他类型, valuefalse

仅有的可平凡复制类型是标量类型、可平凡复制类及这些类型/类的数组(可以为 cv 限定)。

std::remove_all_extents_t<T> 是非(可有 cv 限定的) void 的不完整类型,则行为未定义。

添加 is_trivially_copyable is_trivially_copyable_v (C++17 起) 的特化的程序行为未定义。

模板形参

T - 要检查的类型

辅助变量模板

template< class T >
inline constexpr bool is_trivially_copyable_v = is_trivially_copyable<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>

注解

可平凡复制的对象是仅有的能以 std::memcpy 安全复制或以 std::ofstream::write()/std::ifstream::read() 序列化自/到二进制文件的对象。

一般来说,对于任何可平凡复制类型 TT 对象 obj1 ,能复制 obj1 的底层字节(例如用 std::memcpystd::memmove )到 charunsigned charstd::byte 的数组中,或到 T 的另一不同对象 obj2 中。 obj1obj2 均不可为潜在重叠的子对象。

若复制 obj1 的底层字节到这种数组中,然后复制结果内容回 obj1 中,则 obj1 将保有其原值。若复制 obj1 的底层字节到 obj2 中,则 obj2 将保有 obj1 的值。

示例

#include <iostream>
#include <type_traits>
 
struct A {
    int m;
};
 
struct B {
    B(const B&) {}
};
 
struct C {
    virtual void foo();
};
 
int main()
{
    std::cout << std::boolalpha;
    std::cout << std::is_trivially_copyable<A>::value << '\n';
    std::cout << std::is_trivially_copyable<B>::value << '\n';
    std::cout << std::is_trivially_copyable<C>::value << '\n';
}

输出:

true
false
false

参阅

检查类型是否平凡
(类模板)