CKTIS / C++
new — създаване на обекти и получаване на памет
Изразът new създава обект и връща указател към него; обикновено получава и памет. Разграничете го от алокационната функция operator new и научете за new[] за масиви и израза Placement new, който конструира обект в предоставена памет.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Ако T не е тип масив, new T{args...} създава и инициализира обект и връща указател от тип T*. Изразът new не е същото като функцията operator new: тя предоставя сурова памет, но сама не извиква конструктор. Инициализаторът има значение: new int оставя неопределена стойност, която не трябва да се чете в C++23; new int{} дава нула.
Формата за масив new[], например new T[n]{}, създава масив. При успех и n > 0 тя връща указател към първия елемент. В C++23 n == 0 е допустимо: масивът няма елементи, затова върнатият указател не бива да се разименува. Съчетайте обикновеното new за единичен обект с delete, а new, което създава масив — с delete[], дори когато масивът е с нулева дължина. Например след using T = int[3]; изразът new T{} връща указател от тип int* към първия елемент. За да изтриете масива, трябва да използвате delete[], въпреки че изразът new не съдържа квадратни скоби. Смесването на тези форми води до неопределено поведение. Изтриването на обекти не нулира указателите, които съдържат адресите им.
Стандартната алокационна функция, която хвърля изключения, хвърля std::bad_alloc, когато не може да получи памет. Ако new (std::nothrow) T{} избере стандартното претоварване на алокационната функция, което не хвърля изключения, изразът връща nullptr при неуспешно заделяне на памет. Ако T е класов тип, изразът може вместо това да избере претоварване на алокационната функция, дефинирано в класа, което приема std::nothrow_t, но въпреки това може да хвърли изключение. Дори със стандартното претоварване, което не хвърля изключения, изразът може да предаде нататък изключение от конструктора. Проверете резултата, преди да го разименувате. Ако конструктор хвърли изключение, изразът new извиква подходяща функция за освобождаване, ако намери такава.
Израз Placement new във формата ::new (address) T{args...}, който използва стандартното претоварване, приемащо void* от <new>, конструира обект в съществуваща памет, без да я заделя. Подаденият адрес не трябва да е nullptr, а паметта трябва да е достатъчно голяма, правилно подравнена и налична през целия живот на обекта. За буфера в примера извикайте placed->~Item(), а не delete placed; буферът има собствен жизнен цикъл.
Обхват на записа: C++23. Свързаният флаг на компилатора в хранилището не удостоверява производствената среда за изпълнение. Посоченият URL на стандарта води към развиващ се работен проект, а не към замразено издание на C++23.
Примери
#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();
}
Резултат
7 6 9
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.