CKTIS / C++
std::weak_ptr — beobachten, ohne die Lebensdauer des Objekts zu verlängern
std::weak_ptr<T> beobachtet ein von std::shared_ptr verwaltetes Objekt, ohne es am Leben zu halten. Mit lock() erhält man vorübergehend einen gemeinsamen Besitzer oder einen leeren std::shared_ptr, wenn der Besitz bereits erloschen ist.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <memory>
std::weak_ptr<T> observer = owner;
if (auto held = observer.lock()) {
// Access the object through held.
}std::weak_ptr<T> aus dem Header <memory> speichert eine schwache Referenz, die mit dem von std::shared_ptr verwalteten Besitz verbunden ist. Sie erhöht nicht die Zahl der starken Besitzer und verlängert die Lebensdauer des Objekts nicht. Erzeuge sie aus einem passenden std::shared_ptr oder lasse sie leer.
std::weak_ptr bietet weder * noch ->. Rufe lock() auf und prüfe den zurückgegebenen std::shared_ptr. Das Erlangen gemeinsamen Besitzes ist atomar: Die Methode gibt einen gemeinsamen Besitzer oder einen leeren Zeiger zurück, wenn der Besitz erloschen ist, und löst keine Ausnahmen aus. Halte das Ergebnis während des gesamten Zugriffs auf das Objekt am Leben.
expired() bedeutet use_count() == 0; use_count() zählt starke Besitzer, nicht Beobachter. Die Prüfung von expired() allein sichert die Lebensdauer nicht: Ein anderer Thread kann den letzten Besitzer freigeben, bevor später lock() aufgerufen wird. Die Atomarität von lock() synchronisiert den Zugriff auf die Objektdaten nicht.
Schwache Referenzen eignen sich zum Beobachten und zum Aufbrechen von Besitzzyklen: Eine Rückreferenz kann std::weak_ptr statt eines weiteren starken Besitzers verwenden. reset() leert den Beobachter, ohne das beobachtete Objekt zu zerstören. Das Beispiel verwendet Funktionen, die in C++23 verfügbar sind; der bereitgestellte aktuelle Standardentwurf enthält außerdem spätere Erweiterungen.
Beispiele
#include <iostream>
#include <memory>
int main() {
std::weak_ptr<int> observer;
{
auto owner = std::make_shared<int>(42);
observer = owner;
if (auto held = observer.lock()) {
std::cout << *held << '\n';
}
}
std::cout << std::boolalpha << observer.expired() << '\n';
std::cout << static_cast<bool>(observer.lock()) << '\n';
}
Ergebnis
42 true 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.