std::is_empty

Определён в заголовочном файле `<type_traits>`
template< class T > struct is_empty;		(начиная с C++11)

std::is_empty — это унарное типовое свойство.

Если T является пустым типом (то есть типом класса, не являющимся объединением, без нестатических членов данных, кроме битовых полей нулевого размера, без виртуальных функций, виртуальных базовых классов и непустых базовых классов), предоставляет константу-член value, равную true. Для любого другого типа value равно false.

Если T является неполным типом класса, не являющимся объединением, поведение не определено.

Если программа добавляет специализации для std::is_empty или std::is_empty_v, поведение не определено.

Параметры шаблона

тип для проверки

Вспомогательный шаблон переменной

template< class T >
constexpr bool is_empty_v = is_empty<T>::value;

(начиная с C++17)

Унаследовано от std::integral_constant

Константы-члены

value

[static]

true, если T является типом пустого класса, 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
{
    int:0;
    // C++ standard allows "as a special case, an unnamed bit-field with a width of zero
    // specifies alignment of the next bit-field at an allocation unit boundary.
    // Only when declaring an unnamed bit-field may the width be zero."
};
static_assert(std::is_empty_v<F>); // holds only unnamed bit-fields of zero width

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

int main()
{
    std::cout << std::boolalpha;
    std::cout << "G: " << std::is_empty_v<G> << '\n'; // the result is ABI-dependent
}

Возможный вывод:

G: true

Отчёты об ошибках

Следующие отчёты об ошибках, меняющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

Отчёт об ошибке	Применён к	Поведение согласно опубликованному стандарту	Правильное поведение
LWG 2015	C++11	поведение не определено, если `T` является неполным типом объединения	в этом случае базовая характеристика равна `std::false_type`

См. также

is_class (C++11)	проверяет, является ли тип типом класса, не являющимся объединением (шаблон класса)
is_empty_type (C++26)	проверяет, является ли отражённый тип типом класса (но не объединения) и не имеет ли он нестатических членов данных (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/types/is_empty