std::is_empty

在标头 `<type_traits>` 定义
template< class T > struct is_empty;		(C++11 起)

std::is_empty 是一元类型特性 (UnaryTypeTrait) 。

如果 T 是空类型（即没有除了 0 大小位域以外的非静态数据成员、没有虚函数、没有虚基类，且没有非空基类的非联合类类型），那么成员常量 value 等于 true。对于其它类型，value 等于 false。

如果 T 是不完整的非联合类类型，那么行为未定义。

添加 std::is_empty 或 std::is_empty_v 的特化的程序行为未定义。

模板形参

T

-

要检查的类型

辅助变量模板

template< class T > inline constexpr bool is_empty_v = is_empty<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::is_empty<T> 和所有其他类型特征都是空类。

示例

运行此代码

#include <iostream>
#include <type_traits>
 
struct A {};
static_assert(std::is_empty_v<A> == true);
 
struct B { int m; };
static_assert(std::is_empty_v<B> == false);
 
struct C { static int m; };
static_assert(std::is_empty_v<C> == true);
 
struct D { virtual ~D(); };
static_assert(std::is_empty_v<D> == false);
 
union E {};
static_assert(std::is_empty_v<E> == false);
 
struct F { [[no_unique_address]] E e; };
 
struct G
{
    int:0;
    // C++ 标准允许“作为特殊情况，无名的长度为零的位域指定下个位域在分配单元边界对齐。
    // 仅当声明无名位域时宽度可为零。”
};
static_assert(std::is_empty_v<G> == true); // 宽度为 0 的无名位域
 
int main()
{
    std::cout << std::boolalpha;
    std::cout << "F：" << std::is_empty_v<F> << '\n'; // 结果依赖 API
}

可能的输出：

F：true

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 2015	C++11	在 `T` 是不完整的联合体类型时行为未定义	此时基特征是 std::false_type

参阅

is_class

(C++11)

检查类型是否非联合类类型
(类模板)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库