Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje