CKTIS / C++
std::unique_ptr — výhradní vlastnictví prostředku
std::unique_ptr je chytrý ukazatel s výhradním vlastnictvím, který svůj prostředek automaticky uvolní. Nelze jej kopírovat, vlastnictví však lze přesunout na jiný ukazatel.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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> z <memory> uchovává ukazatel a deleter. Při zničení vlastníka zavolá deleter pro nenulový ukazatel; jde o použití RAII. Výchozí deleter používá delete pro jeden objekt. Parametr D umožňuje přizpůsobit uvolňování prostředku.
Objekt vytvoříte pomocí std::make_unique<T>(args...). Kopírování std::unique_ptr není povoleno. Inicializace auto q = std::move(p); přesune vlastnictví na q a ponechá p prázdný. Samotné std::move(p) prostředek nepřesouvá; umožňuje zvolit operaci přesunu. Před dereferencováním potenciálně prázdného ukazatele jej zkontrolujte pomocí if (p).
get() zpřístupní ukazatel, aniž byste se vzdali vlastnictví. reset() uvolní dosavadní prostředek a ponechá vlastníka prázdného; reset(ptr) přijme náhradní ukazatel. release() vrátí ukazatel, aniž by prostředek uvolnil, takže volající kód musí zajistit jeho pozdější uvolnění. Nevytvářejte dva nezávislé vlastníky stejného surového ukazatele a výsledek get() ručně nemažte.
Pro pole použijte std::unique_ptr<T[]>: ve výchozím nastavení volá delete[] a poskytuje operator[] namísto operator* a operator->. std::make_unique<T[]>(count) vytvoří takové pole. Tento záznam se vztahuje k C++23; uvedený web zveřejňuje průběžně vyvíjený návrh, nikoli neměnný text C++23. Příznak kompilátoru v repozitáři nepotvrzuje produkční běhové prostředí.
Příklady
#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';
}
Výsledek
p owns: false value: 42 q owns: false
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.