Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

new — vytváření objektů a získávání úložiště

Výraz new vytvoří objekt a vrátí na něj ukazatel; obvykle také získá úložiště. Rozlišujte jej od alokační funkce operator new a seznamte se s new[] pro pole a výrazem Placement new, který vytvoří objekt v dodaném úložišti.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}

Pokud T není typ pole, new T{args...} vytvoří a inicializuje objekt a vrátí ukazatel typu T*. Výraz new není totéž co funkce operator new: ta poskytuje surové úložiště, ale sama nevolá konstruktor. Na inicializátoru záleží: new int ponechá neurčitou hodnotu, kterou v C++23 nelze číst; new int{} vytvoří nulu.

Forma new[], například new T[n]{}, vytvoří pole. Pokud operace uspěje a n > 0, vrátí ukazatel na první prvek. V C++23 je n == 0 povoleno: pole neobsahuje žádné prvky, takže vrácený ukazatel nesmíte dereferencovat. Pro běžné new vytvářející jeden objekt používejte delete a pro new vytvářející pole používejte delete[], a to i u pole nulové délky. Například po using T = int[3]; vrátí new T{} ukazatel typu int* na první prvek. K odstranění pole musíte použít delete[], přestože výraz new neobsahuje hranaté závorky. Smíchání těchto forem způsobuje nedefinované chování. Odstranění objektů neresetuje ukazatele, které uchovávají jejich adresy.

Standardní alokační funkce, která vyhazuje výjimky, vyhodí std::bad_alloc, pokud nedokáže získat úložiště. Pokud new (std::nothrow) T{} vybere standardní přetížení alokační funkce, které nevyhazuje výjimky, výraz při selhání alokace vrátí nullptr. Je-li T typ třídy, výraz může místo toho vybrat přetížení alokační funkce definované ve třídě, které přijímá std::nothrow_t, ale přesto může vyhodit výjimku. I při použití standardního přetížení, které nevyhazuje výjimky, může výraz propagovat výjimku konstruktoru. Před dereferencováním výsledek zkontrolujte. Pokud konstruktor vyhodí výjimku, výraz new zavolá vhodnou dealokační funkci, pokud ji najde.

Výraz Placement new ve tvaru ::new (address) T{args...}, který používá standardní přetížení přijímající void* z <new>, vytvoří objekt ve stávajícím úložišti, aniž by je alokoval. Předaná adresa nesmí být nullptr a úložiště musí být dostatečně velké, správně zarovnané a dostupné po celou dobu života objektu. Pro buffer v příkladu zavolejte placed->~Item(), nikoli delete placed; buffer má vlastní dobu života.

Rozsah záznamu: C++23. Související příznak překladače v repozitáři nepotvrzuje produkční běhové prostředí. Uvedená URL normy odkazuje na průběžně se vyvíjející pracovní návrh, nikoli na zmrazené vydání C++23.

Pří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ýsledek

7
6
9

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje