CKTIS / C++
std::unique_ptr — изключителна собственост върху ресурс
std::unique_ptr е интелигентен указател с изключителна собственост, който автоматично освобождава ресурса си. Не може да се копира, но собствеността може да се премести към друг указател.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <memory>
std::unique_ptr<T> p = std::make_unique<T>(args...);
std::unique_ptr<T, Deleter> custom;
std::unique_ptr<T[]> array = std::make_unique<T[]>(count);std::unique_ptr<T, D> от <memory> съхранява указател и deleter. Когато притежателят бъде унищожен, той извиква deleter за указател, който не е null; това е приложение на RAII. Deleter по подразбиране използва delete за единичен обект. Параметърът D позволява да персонализирате освобождаването на ресурса.
Използвайте std::make_unique<T>(args...), за да създадете обект. Копирането на std::unique_ptr е забранено. Инициализацията с auto q = std::move(p); прехвърля собствеността към q и оставя p празен. Само по себе си std::move(p) не прехвърля ресурса; то позволява да се избере операция за преместване. Преди да дереферирате указател, който може да е празен, проверете го с if (p).
get() предоставя указателя, без да се отказвате от собствеността. reset() освобождава предишния ресурс и оставя притежателя празен; reset(ptr) приема заместващ указател. release() връща указателя, без да освобождава ресурса, така че извикващият код трябва да се погрижи за последващото му освобождаване. Не създавайте двама независими притежатели на един и същ суров указател и не изтривайте ръчно резултата от get().
За масиви използвайте std::unique_ptr<T[]>: по подразбиране извиква delete[] и предоставя operator[] вместо operator* и operator->. std::make_unique<T[]>(count) създава такъв масив. Тази статия е за C++23; посоченият сайт публикува развиващ се проект, а не замразен текст на C++23. Флагът на компилатора в хранилището не удостоверява продукционната среда за изпълнение.
Примери
#include <iostream>
#include <memory>
#include <utility>
int main() {
auto p = std::make_unique<int>(42);
auto q = std::move(p);
std::cout << std::boolalpha;
std::cout << "p owns: " << static_cast<bool>(p) << '\n';
std::cout << "value: " << *q << '\n';
q.reset();
std::cout << "q owns: " << static_cast<bool>(q) << '\n';
}
Резултат
p owns: false value: 42 q owns: false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.