std::destroy
С сайта ru.cppreference.net
| Определено в заголовке <memory>
|
||
template< class ForwardIt >
void destroy( ForwardIt first, ForwardIt last );
|
(1) | (начиная с C++17) (до C++20) |
template< class ForwardIt >
constexpr void destroy( ForwardIt first, ForwardIt last );
|
(начиная с C++20) | |
template< class ExecutionPolicy, class ForwardIt >
void destroy( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last );
|
(2) | (начиная с C++17) |
1) Уничтожает элементы в целевом диапазоне
[first, last) как если бы
for (; first != last; ++first)
std::destroy_at(std::addressof(*first));
2) То же, что и (1), но выполняется в соответствии с
policy. Эта перегрузка участвует в разрешении перегрузки, только если значение следующего выражения является
true:
|
|
(до C++20) |
|
|
(начиная с C++20) |
Параметры
| first, last | - | пара итераторов, определяющих диапазон элементов для уничтожения |
| policy | - | политика выполнения для использования |
| Требования к типам | ||
-
ForwardIt
должен удовлетворять требованиям
LegacyForwardIterator
.
|
||
-
ForwardIt
не должны выбрасывать исключения.
|
||
Исключения
2) Во время процесса выполнения:
- Если временные ресурсы памяти, необходимые для распараллеливания, недоступны, std::bad_alloc выбрасывается.
- Если необработанное исключение выбрасывается при доступе к объектам через аргумент алгоритма, поведение определяется политикой выполнения (для стандартных политик, вызывается std::terminate).
Возможная реализация
template<class ForwardIt> constexpr // начиная с C++20 void destroy(ForwardIt first, ForwardIt last) { for (; first != last; ++first) std::destroy_at(std::addressof(*first)); } |
Пример
Демонстрирует использование destroy для уничтожения непрерывной последовательности элементов.
Запустить этот код
#include <iostream>
#include <memory>
#include <new>
struct Tracer
{
int value;
~Tracer() { std::cout << value << " destructed\n"; }
};
int main()
{
alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 4];
for (int i = 0; i < 4; ++i)
new (buffer + sizeof(Tracer) * i) Tracer{i}; // manually construct objects
auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer));
std::destroy(ptr, ptr + 4);
}
Вывод:
0 destructed
1 destructed
2 destructed
3 destructed
Смотрите также
|
(C++17)
|
уничтожает несколько объектов в диапазоне
(шаблон функции) |
|
(C++17)
|
уничтожает объект по заданному адресу
(шаблон функции) |
|
(C++20)
|
уничтожает диапазон объектов
(функциональный объект алгоритма) |