CKTIS / C++
new — vytváranie objektov a získavanie úložiska
Výraz new vytvorí objekt a vráti naň ukazovateľ; zvyčajne tiež získa úložisko. Odlišujte ho od alokačnej funkcie operator new a oboznámte sa s new[] pre polia a výrazom Placement new, ktorý vytvorí objekt v poskytnutom úložisku.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Ak T nie je typ poľa, new T{args...} vytvorí a inicializuje objekt a vráti ukazovateľ typu T*. Výraz new nie je to isté ako funkcia operator new: tá poskytuje surové úložisko, ale sama nevolá konštruktor. Na inicializátore záleží: new int ponechá neurčitú hodnotu, ktorú v C++23 nemožno čítať; new int{} vytvorí nulu.
Forma new[], napríklad new T[n]{}, vytvorí pole. Ak je operácia úspešná a n > 0, vráti ukazovateľ na prvý prvok. V C++23 je n == 0 povolené: pole nemá žiadne prvky, takže vrátený ukazovateľ nesmiete dereferencovať. Pre bežné new vytvárajúce jeden objekt použite delete a pre new vytvárajúce pole použite delete[], aj keď má pole nulovú dĺžku. Napríklad po using T = int[3]; vráti new T{} ukazovateľ typu int* na prvý prvok. Na odstránenie poľa musíte použiť delete[], hoci výraz new neobsahuje hranaté zátvorky. Zmiešanie týchto foriem spôsobuje nedefinované správanie. Odstránenie objektov neresetuje ukazovatele, ktoré uchovávajú ich adresy.
Štandardná alokačná funkcia, ktorá vyhadzuje výnimky, vyhodí std::bad_alloc, ak nedokáže získať úložisko. Ak new (std::nothrow) T{} vyberie štandardné preťaženie alokačnej funkcie, ktoré nevyhadzuje výnimky, výraz pri zlyhaní alokácie vráti nullptr. Ak je T typ triedy, výraz môže namiesto toho vybrať preťaženie alokačnej funkcie definované v triede, ktoré prijíma std::nothrow_t, ale napriek tomu môže vyhodiť výnimku. Aj pri použití štandardného preťaženia, ktoré nevyhadzuje výnimky, môže výraz propagovať výnimku konštruktora. Pred dereferencovaním výsledok skontrolujte. Ak konštruktor vyhodí výnimku, výraz new zavolá vhodnú dealokačnú funkciu, ak nejakú nájde.
Výraz Placement new v tvare ::new (address) T{args...}, ktorý používa štandardné preťaženie prijímajúce void* z <new>, vytvorí objekt v existujúcom úložisku bez jeho alokácie. Odovzdaná adresa nesmie byť nullptr a úložisko musí byť dostatočne veľké, správne zarovnané a dostupné počas celej životnosti objektu. Pre buffer v príklade zavolajte placed->~Item(), nie delete placed; buffer má vlastnú životnosť.
Rozsah záznamu: C++23. Súvisiaci príznak prekladača v repozitári nepotvrdzuje produkčné runtime prostredie. Uvedená URL normy odkazuje na priebežne sa vyvíjajúci pracovný návrh, nie na zmrazené vydanie C++23.
Príklady
#include <cstddef>
#include <iostream>
#include <new>
struct Item {
int value;
};
int main() {
int* single = new int{7};
std::cout << *single << '\n';
delete single;
int* array = new int[3]{1, 2, 3};
std::cout << array[0] + array[1] + array[2] << '\n';
delete[] array;
alignas(Item) std::byte storage[sizeof(Item)];
Item* placed = ::new (static_cast<void*>(storage)) Item{9};
std::cout << placed->value << '\n';
placed->~Item();
}
Výsledok
7 6 9
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.