std::destroy_at — cppreference.com

Материал из cppreference.com

Определено в заголовочном файле `<memory>`
`template< class T > void destroy_at( T* p );`		(начиная с C++17) (до C++20)
`template< class T > constexpr void destroy_at( T* p );`		(начиная с C++20)

Если T не является типом массива, вызывает деструктор объекта, на который указывает p, как если бы p->~T().

Если T является типом массива, программа не корректна (до C++20)рекурсивно уничтожает элементы *p по порядку, как если бы вызвали std::destroy(std::begin(*p), std::end(*p)) (начиная с C++20).

Параметры

—

указатель на объект, который нужно уничтожить

Возвращаемое значение

(нет)

Возможная реализация

template<class T>
constexpr void destroy_at(T* p) 
{
    if constexpr (std::is_array_v<T>)
        for (auto &elem : *p)
            (destroy_at)(std::addressof(elem));
    else
        p->~T(); 
}
// версия C++17:
// template<class T> void destroy_at(T* p) { p->~T(); }

Примечание

destroy_at выводит тип объекта, подлежащего уничтожению, и, следовательно, позволяет избежать его явной записи в вызове деструктора.

Когда destroy_at вызывается при оценке некоторого константного выражения e, аргумент p должен указывать на объект, время жизни которого началось при оценке e.

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

Пример

В следующем примере показано, как использовать destroy_at для уничтожения непрерывной последовательности элементов.

#include <iostream>
#include <memory>
#include <new>

struct Tracer
{
    int value;
    ~Tracer() { std::cout << value << " уничтожен\n"; }
};

int main()
{
    alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 8];
    
    for (int i = 0; i < 8; ++i)
        new(buffer + sizeof(Tracer) * i) Tracer{i}; //создаём объекты вручную

    auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer));

    for (int i = 0; i < 8; ++i)
        std::destroy_at(ptr + i);
}

Вывод:

0 уничтожен
1 уничтожен
2 уничтожен
3 уничтожен
4 уничтожен
5 уничтожен
6 уничтожен
7 уничтожен

Смотрите также

Категории: