CKTIS / C++
std::unique_ptr — exklusiver Besitz einer Ressource
std::unique_ptr ist ein Smart Pointer mit exklusivem Besitz, der seine Ressource automatisch freigibt. Er kann nicht kopiert werden, aber der Besitz lässt sich auf einen anderen Pointer übertragen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#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> aus <memory> speichert einen Pointer und einen Deleter. Wird der Besitzer zerstört, ruft er den Deleter für einen nicht-null Pointer auf; das ist eine Anwendung von RAII. Der Standard-Deleter verwendet delete für ein einzelnes Objekt. Mit dem Parameter D lässt sich die Freigabe der Ressource anpassen.
Verwende std::make_unique<T>(args...), um ein Objekt zu erstellen. Das Kopieren eines std::unique_ptr ist nicht erlaubt. Die Initialisierung mit auto q = std::move(p); überträgt den Besitz auf q und lässt p leer zurück. std::move(p) allein überträgt die Ressource nicht, sondern ermöglicht die Auswahl einer Verschiebeoperation. Prüfe einen möglicherweise leeren Pointer mit if (p), bevor du ihn dereferenzierst.
get() gibt den Pointer heraus, ohne den Besitz abzugeben. reset() gibt die bisherige Ressource frei und lässt den Besitzer leer zurück; reset(ptr) übernimmt einen Ersatz-Pointer. release() gibt den Pointer zurück, ohne die Ressource freizugeben. Daher muss der aufrufende Code für ihre spätere Freigabe sorgen. Erzeuge nicht zwei unabhängige Besitzer desselben Raw Pointers und lösche das Ergebnis von get() nicht manuell.
Für Arrays verwendest du std::unique_ptr<T[]>: Standardmäßig ruft es delete[] auf und stellt operator[] statt operator* und operator-> bereit. std::make_unique<T[]>(count) erstellt ein solches Array. Dieser Eintrag bezieht sich auf C++23; die bereitgestellte Website veröffentlicht einen fortlaufend weiterentwickelten Entwurf, keinen eingefrorenen C++23-Text. Das Compiler-Flag des Repositorys bestätigt nicht die Produktionslaufzeit.
Beispiele
#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';
}
Ergebnis
p owns: false value: 42 q owns: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.