Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

new — tworzenie obiektów i przydzielanie pamięci

Wyrażenie new tworzy obiekt i zwraca wskaźnik do niego; zwykle pozyskuje też pamięć. Odróżnij je od funkcji alokującej operator new, poznaj tablicowe new[] oraz Placement new-expression, które konstruuje obiekt w dostarczonej pamięci.

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

Składnia

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

Jeśli T nie jest typem tablicowym, new T{args...} tworzy i inicjalizuje obiekt, zwracając wskaźnik typu T*. Wyrażenie new to nie to samo co funkcja operator new: ta druga dostarcza surową pamięć, ale sama nie wywołuje konstruktora. Inicjalizator ma znaczenie: new int pozostawia wartość nieokreśloną, której nie wolno odczytywać w C++23; new int{} daje zero.

Postać tablicowa new[], np. new T[n]{}, tworzy tablicę. Jeśli operacja się powiedzie i n > 0, zwraca wskaźnik do pierwszego elementu. W C++23 n == 0 jest dozwolone: tablica nie ma elementów, więc zwróconego wskaźnika nie wolno dereferencjonować. Zwykłe new dla pojedynczego obiektu łącz z delete, a new tworzące tablicę z delete[], także dla tablicy o zerowej długości. Przykładowo po using T = int[3]; wyrażenie new T{} zwraca wskaźnik typu int* do pierwszego elementu. Mimo braku nawiasów kwadratowych w tym wyrażeniu do usunięcia tablicy trzeba użyć delete[]. Pomieszanie tych postaci powoduje niezdefiniowane zachowanie. Usunięcie obiektów nie zeruje przechowujących ich adresy wskaźników.

Standardowa rzucająca funkcja alokująca zgłasza std::bad_alloc, gdy nie może przydzielić pamięci. Jeśli new (std::nothrow) T{} wybierze standardowe przeciążenie funkcji alokującej, które nie zgłasza wyjątków, wyrażenie zwróci nullptr przy niepowodzeniu alokacji. Gdy T jest typem klasowym, wyrażenie może jednak wybrać przeciążenie zdefiniowane w klasie, które przyjmuje std::nothrow_t, ale mimo to może zgłosić wyjątek. Nawet przy standardowym przeciążeniu, które nie zgłasza wyjątków, wyrażenie może propagować wyjątek konstruktora. Sprawdź wynik przed dereferencją. Jeśli konstruktor zgłosi wyjątek, wyrażenie new wywołuje odpowiednią funkcję zwalniającą, o ile ją znajdzie.

Placement new-expression w postaci ::new (address) T{args...}, ze standardowym przeciążeniem przyjmującym void* z <new>, konstruuje obiekt w istniejącej pamięci bez jej przydzielania. Przekazany adres nie może być nullptr, a pamięć musi być wystarczająco duża, poprawnie wyrównana i dostępna przez cały czas życia obiektu. Dla bufora z przykładu wywołaj placed->~Item(), nie delete placed; bufor ma własny czas życia.

Zakres wpisu: C++23. Powiązany znacznik kompilatora w repozytorium nie potwierdza środowiska produkcyjnego. Podany adres standardu prowadzi do rozwijanego szkicu, a nie zamrożonego wydania C++23.

Przykłady

#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();
}

Wynik

7
6
9

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła