# std::is_empty

< cpp‎ | types

定义于头文件 `<type_traits>` |  |
template< class T > struct is_empty; |  | (C++11 起)

若 `T` 是空类类型（即无异于 0 大小位域的非静态数据成员、无虚函数、无虚基类，且无非空基类的非联合类类型），则提供等于 true 的成员常量 `value` 。对于任何其他类型， `value` 为 false 。

若 `T` 是非联合类类型，则 `T` 应是完整类型；否则行为未定义。

添加 `is_empty` 或 `is_empty_v` (C++17 起) 的特化的程序行为未定义。

### 模板形参

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 {};

    struct B {
        int m;
    };

    struct C {
        static int m;
    };

    struct D {
        virtual ~D();
    };

    union E {};

    struct F {
        [[no_unique_address]] E e;
    };

    struct G {
        int:0;
        // C++ 标准允许“作为特殊情况，无名的长度为零的位域指定下个位域在分配单元边界对齐。
        // 仅当声明无名位域时宽度可为零。”
    };

    int main()
    {
        std::cout << std::boolalpha;
        std::cout << "A " << std::is_empty<A>::value << '\n';
        std::cout << "B " << std::is_empty<B>::value << '\n';
        std::cout << "C " << std::is_empty<C>::value << '\n';
        std::cout << "D " << std::is_empty<D>::value << '\n';
        std::cout << "E " << std::is_empty<E>::value << '\n';
        std::cout << "F " << std::is_empty<F>::value << '\n'; // 结果依赖 ABI
        std::cout << "G " << std::is_empty<F>::value << '\n'; // 0 宽度的无名位域
    }

可能的输出：

    A true
    B false
    C true
    D false
    E false
    F true
    G true

### 参阅

is_class (C++11) | 检查类型是否非联合类类型 (类模板)