CKTIS / C++
Placement new: конструиране в съществуваща памет
Конструирай обект в подготвено място, управлявай живота му отделно от паметта и забрани копирането и преместването на собственика на мястото.
Версия: ISO C++23; implementation support may vary
Синтаксис
#include <new>
// Assumes overload resolution selects the standard non-allocating placement overload.
T* p = ::new (static_cast<void*>(storage)) T(args...); // Construct one T in existing storage.
p->~T(); // Destroy that T without freeing the storage.
// Inside the owning class, disable copying and moving:
Owner(const Owner&) = delete;
Owner& operator=(const Owner&) = delete;
Owner(Owner&&) = delete;
Owner& operator=(Owner&&) = delete;В C++23 изразът ::new (static_cast<void*>(storage)) T(args...) конструира T на подадения адрес и връща T*, ако бъде избран стандартният незаделящ памет вариант operator new(std::size_t, void*) от <new>. Тази глобална функция само връща адреса. Началното :: пропуска търсенето в класа, но преобразуването към void* не гарантира избора на стандартния вариант. Ако alignof(T) > __STDCPP_DEFAULT_NEW_ALIGNMENT__, при избора между претоварените функции първо се включва допълнителен аргумент от тип std::align_val_t. Затова вместо стандартния вариант може да бъде избран подходящ глобален вариант на placement new, който приема аргумент за подравняване. Ако не се намери съответстваща функция за заделяне на памет, изборът се повтаря без аргумента за подравняване. Обикновеният заделящ памет израз new T(args...) осигурява памет и инициализира обекта. Други варианти на placement new могат да заделят памет.
Подай валиден ненулев адрес с поне sizeof(T) налични байта и подравняване, което отговаря на alignof(T). Примерът използва alignas(Item) за подравняването. Животът на конструирания обект започва след успешна инициализация. Ако конструкторът хвърли изключение, съответният стандартен placement operator delete(void*, void*) не освобождава памет. Отбележи мястото като заето едва след успешното конструиране.
Запази T*, върнат от израза new. Самото преобразуване на тип не конструира обекта, а съвпадението на адресите не разрешава достъп през несъвместим тип (правилата за strict aliasing). std::launder може да върне указател към вече жив обект от подобен тип на този адрес, ако е изпълнено условието за достижимост на байтовете. Функцията нито започва живота на обекта, нито поправя подравняването. Тук не е необходима.
Явното извикване на деструктора p->~T() унищожава обекта, без да освобождава паметта на арената или буфера. При този модел унищожавай всеки успешно конструиран обект точно веднъж, преди да използваш мястото отново или преди да приключи животът на буфера. Не използвай delete p за обект в този буфер: изразът delete, съчетан с подходящ заделящ памет израз new, обикновено унищожава обекта и освобождава паметта.
= delete дефинира изтрита функция; това не е израз delete. Функцията продължава да участва в избора между претоварени функции, но извикване, което я избира, е невалидно. Slot изтрива конструкторите за копиране и преместване и двата съответни оператора за присвояване. Копирането на членовете по подразбиране би копирало указателя към изходния буфер, без да конструира Item в целевия буфер.
Примери
#include <cstddef>
#include <cstdio>
#include <new>
struct Item {
int value;
explicit Item(int n) : value(n) {}
~Item() { std::puts("destroyed"); }
};
class Slot {
alignas(Item) std::byte storage_[sizeof(Item)];
Item* item_ = nullptr;
public:
Slot() = default;
~Slot() { reset(); }
Slot(const Slot&) = delete;
Slot& operator=(const Slot&) = delete;
Slot(Slot&&) = delete;
Slot& operator=(Slot&&) = delete;
Item& emplace(int n) {
reset();
item_ = ::new (static_cast<void*>(storage_)) Item(n);
return *item_;
}
void reset() noexcept {
if (item_) {
item_->~Item();
item_ = nullptr;
}
}
};
int main() {
Slot slot;
std::printf("%d\n", slot.emplace(7).value);
std::printf("%d\n", slot.emplace(9).value);
}Резултат
7 destroyed 9 destroyed
Второто извикване на `emplace` унищожава `Item` със стойност `7`, преди да конструира обекта със стойност `9` в същия буфер. Деструкторът на `Slot` унищожава втория обект.
Свързани уроци
- C++ · Урок 16 · Напреднало · Версия: 3
- C++ · Урок 19 · Напреднало · Версия: 3
Източници
- WG21 N4950 — Working Draft, Standard for Programming Language C++ (C++23 baseline)
- New expressions [expr.new] — C++ working draft
- Non-allocating forms [new.delete.placement] — C++ working draft
- Lifetime [basic.life] — C++ working draft
- Value category and type accessibility [basic.lval] — C++ working draft
- Pointer optimization barrier [ptr.launder] — C++ working draft
- Destructors [class.dtor] — C++ working draft
- Delete expressions [expr.delete] — C++ working draft
- Deleted definitions [dcl.fct.def.delete] — C++ working draft