CKTIS / C++
new — ustvarjanje objektov in pridobivanje pomnilnika
Izraz new ustvari objekt in vrne kazalec nanj; običajno pridobi tudi pomnilnik. Ločite ga od alokacijske funkcije operator new ter spoznajte new[] za polja in izraz Placement new, ki objekt ustvari v zagotovljenem pomnilniku.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Če T ni tip polja, new T{args...} ustvari in inicializira objekt ter vrne kazalec tipa T*. Izraz new ni isto kot funkcija operator new: ta zagotovi surov pomnilnik, vendar sama ne pokliče konstruktorja. Inicializator je pomemben: new int pusti nedoločeno vrednost, ki je v C++23 ne smemo brati; new int{} ustvari ničlo.
Oblika new[], na primer new T[n]{}, ustvari polje. Če je operacija uspešna in n > 0, vrne kazalec na prvi element. V C++23 je n == 0 dovoljeno: polje nima elementov, zato vrnjenega kazalca ne smete dereferencirati. Za običajni new za posamezen objekt uporabite delete, za new, ki ustvari polje, pa delete[], tudi če je dolžina polja nič. Po deklaraciji using T = int[3]; na primer new T{} vrne kazalec tipa int* na prvi element. Za brisanje polja morate uporabiti delete[], čeprav izraz new ne vsebuje oglatih oklepajev. Mešanje teh oblik povzroči nedefinirano vedenje. Brisanje objektov ne ponastavi kazalcev, ki hranijo njihove naslove.
Standardna alokacijska funkcija, ki meče izjeme, vrže std::bad_alloc, kadar ne more pridobiti pomnilnika. Če new (std::nothrow) T{} izbere standardno preobremenitev alokacijske funkcije, ki ne meče izjem, izraz ob neuspešni alokaciji vrne nullptr. Če je T razredni tip, lahko izraz namesto tega izbere preobremenitev alokacijske funkcije, določeno v razredu, ki sprejme std::nothrow_t, vendar lahko kljub temu vrže izjemo. Tudi pri standardni preobremenitvi, ki ne meče izjem, lahko izraz posreduje izjemo konstruktorja. Pred dereferenciranjem preverite rezultat. Če konstruktor vrže izjemo, izraz new pokliče ustrezno funkcijo za sprostitev pomnilnika, če jo najde.
Izraz Placement new v obliki ::new (address) T{args...}, ki uporablja standardno preobremenitev void* iz <new>, ustvari objekt v obstoječem pomnilniku, ne da bi ga alociral. Podani naslov ne sme biti nullptr, pomnilnik pa mora biti dovolj velik, pravilno poravnan in na voljo vso življenjsko dobo objekta. Za medpomnilnik v primeru pokličite placed->~Item(), ne delete placed; medpomnilnik ima svojo življenjsko dobo.
Obseg vnosa: C++23. Povezana možnost prevajalnika v repozitoriju ne potrjuje produkcijskega izvajalnega okolja. Navedeni URL standarda kaže na razvijajoči se delovni osnutek, ne na zamrznjeno izdajo C++23.
Primeri
#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();
}
Rezultat
7 6 9
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.