std::weak_ptr<T>:: lock

Erstellt einen neuen std::shared_ptr , der die Eigentümerschaft des verwalteten Objekts teilt. Wenn kein verwaltetes Objekt vorhanden ist, d.h. * this leer ist, dann ist der zurückgegebene shared_ptr ebenfalls leer.

Effektiv gibt expired ( ) ? shared_ptr < T > ( ) : shared_ptr < T > ( * this ) zurück, atomar ausgeführt.

Rückgabewert

Ein shared_ptr , der die Eigentümerschaft des besessenen Objekts teilt, falls std::weak_ptr::expired false zurückgibt. Andernfalls wird ein standardkonstruierter shared_ptr vom Typ T zurückgegeben.

Hinweise

Sowohl diese Funktion als auch der Konstruktor von std::shared_ptr können verwendet werden, um temporären Besitz des verwalteten Objekts zu erlangen, auf das ein std::weak_ptr verweist. Der Unterschied besteht darin, dass der Konstruktor von std::shared_ptr eine Exception wirft, wenn sein std::weak_ptr Argument leer ist, während std::weak_ptr<T>::lock() einen leeren std::shared_ptr<T> konstruiert.

Beispiel

#include <iostream>
#include <memory>
void observe(std::weak_ptr<int> weak)
{
    if (auto p = weak.lock())
        std::cout << "\tobserve() is able to lock weak_ptr<>, value=" << *p << '\n';
    else
        std::cout << "\tobserve() is unable to lock weak_ptr<>\n";
}
int main()
{
    std::weak_ptr<int> weak;
    std::cout << "weak_ptr<> is not yet initialized\n";
    observe(weak);
    {
        auto shared = std::make_shared<int>(42);
        weak = shared;
        std::cout << "weak_ptr<> is initialized with shared_ptr\n";
        observe(weak);
    }
    std::cout << "shared_ptr<> has been destructed due to scope exit\n";
    observe(weak);
}

weak_ptr<> is not yet initialized
        observe() is unable to lock weak_ptr<>
weak_ptr<> is initialized with shared_ptr
        observe() is able to lock weak_ptr<>, value=42
shared_ptr<> has been destructed due to scope exit
        observe() is unable to lock weak_ptr<>

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch