CKTIS / C++
Placement new: konštrukcia v existujúcej pamäti
Vytvorte objekt v pripravenom slote, spravujte jeho životnosť nezávisle od pamäte a zakážte kopírovanie aj presúvanie vlastníka slotu.
Verzia: ISO C++23; implementation support may vary
Syntax
#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;V C++23 výraz ::new (static_cast<void*>(storage)) T(args...) skonštruuje T na zadanej adrese a vráti T*, ak sa vyberie štandardné nealokujúce preťaženie operator new(std::size_t, void*) z <new>. Toto globálne preťaženie iba vráti adresu. Úvodné :: obíde vyhľadávanie v triede, ale pretypovanie na void* nezaručuje výber štandardného preťaženia. Ak platí alignof(T) > __STDCPP_DEFAULT_NEW_ALIGNMENT__, pri výbere preťaženia sa najskôr zohľadní ďalší argument typu std::align_val_t, takže sa namiesto štandardného preťaženia môže vybrať vhodné globálne preťaženie placement new, ktoré prijíma argument zarovnania. Ak sa nenájde zodpovedajúca alokačná funkcia, výber preťaženia sa zopakuje bez argumentu zarovnania. Bežný alokujúci výraz new T(args...) získa pamäť a inicializuje objekt. Iné preťaženia placement new môžu alokovať pamäť.
Odovzdajte platnú nenulovú adresu s aspoň sizeof(T) dostupnými bajtmi a zarovnaním vyhovujúcim alignof(T). Príklad zabezpečuje zarovnanie pomocou alignas(Item). Životnosť konštruovaného objektu sa začína po úspešnej inicializácii. Ak konštruktor vyvolá výnimku, zodpovedajúci štandardný placement operator delete(void*, void*) nič neuvoľní. Slot označte ako obsadený až po úspešnej konštrukcii.
Uchovajte T* vrátený výrazom new. Samotné pretypovanie objekt nekonštruuje a zhodná adresa nedovoľuje prístup cez nekompatibilný typ (pravidlá strict aliasing). std::launder môže získať ukazovateľ na už živý objekt podobného typu na tejto adrese, ak je splnená podmienka dosiahnuteľnosti bajtov. Nezačína životnosť ani neopravuje zarovnanie. Tu nie je potrebný.
Explicitné volanie deštruktora p->~T() zničí objekt bez uvoľnenia pamäte arény alebo vyrovnávacej pamäte. V tomto vzore zničte každý úspešne skonštruovaný objekt presne raz, než slot znovu použijete alebo než sa skončí životnosť vyrovnávacej pamäte. Na objekt v tejto vyrovnávacej pamäti nepoužívajte delete p: výraz delete spárovaný s vhodným alokujúcim výrazom new zvyčajne zničí objekt a uvoľní pamäť.
= delete definuje odstránenú funkciu; nejde o výraz delete. Funkcia sa naďalej zúčastňuje výberu preťaženia, ale volanie, ktoré ju vyberie, je neplatné. Slot odstraňuje kopírovací a presúvací konštruktor aj oba zodpovedajúce operátory priradenia. Predvolené kopírovanie po členoch by skopírovalo ukazovateľ do zdrojovej vyrovnávacej pamäte bez skonštruovania Item v cieľovej pamäti.
Príklady
#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);
}Výsledok
7 destroyed 9 destroyed
Druhé volanie `emplace` zničí `Item` s hodnotou `7` a potom v rovnakej vyrovnávacej pamäti skonštruuje objekt s hodnotou `9`. Deštruktor `Slot` zničí druhý objekt.
Súvisiace lekcie
- C++ · Lekcia 16 · Pokročilá · Verzia: 3
- C++ · Lekcia 19 · Pokročilá · Verzia: 3
Zdroje
- 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