Spec-Zone.ru › C++

std::is_aggregate

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

std::is_aggregate является унарным типовым признаком.

Если T является агрегатным типом, предоставляет константу-член value, равную true. Для любого другого типа value равно false.

Если T является неполным типом, отличным от типа массива или (возможно, cv-квалифицированного) void, поведение не определено.

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

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

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

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

template< class T >
constexpr bool is_aggregate_v = is_aggregate<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>

Примечания

Макрос проверки поддержки возможностей Значение Стандарт Возможность
__cpp_lib_is_aggregate 201703L (C++17) std::is_agregate

Пример

#include <algorithm>
#include <cassert>
#include <cstddef>
#include <new>
#include <string_view>
#include <type_traits>
#include <utility>

// Constructs a T at the uninitialized memory pointed to by p using
// list-initialization for aggregates and non-list initialization otherwise.
template<class T, class... Args>
T* construct(T* p, Args&&... args)
{
    if constexpr (std::is_aggregate_v<T>)
        return ::new (static_cast<void*>(p)) T{std::forward<Args>(args)...};
    else
        return ::new (static_cast<void*>(p)) T(std::forward<Args>(args)...);
}

struct A { int x, y; };
static_assert(std::is_aggregate_v<A>);

struct B
{
    int i;
    std::string_view str;

    B(int i, std::string_view str) : i(i), str(str) {}
};
static_assert(not std::is_aggregate_v<B>);

template <typename... Ts>
using aligned_storage_t = alignas(Ts...) std::byte[std::max({sizeof(Ts)...})];

int main()
{
    aligned_storage_t<A, B> storage;

    A& a = *construct(reinterpret_cast<A*>(&storage), 1, 2);
    assert(a.x == 1 and a.y == 2);

    B& b = *construct(reinterpret_cast<B*>(&storage), 3, "4");
    assert(b.i == 3 and b.str == "4");
}

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

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

Отчёт об ошибке Применён к Опубликованное поведение Корректное поведение
LWG 3823 C++17 Поведение не определено, если T является типом массива, но
std::remove_all_extents_t<T> является неполным типом.
Поведение определено независимо от
неполноты std::remove_all_extents_t<T>,
если T является типом массива.

См. также

is_aggregate_type
(C++26)
проверяет, является ли отражённый тип агрегатным типом
(функция)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API