Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::weak_ptr — obserwacja bez przedłużania życia obiektu

std::weak_ptr<T> obserwuje obiekt zarządzany przez std::shared_ptr bez utrzymywania go przy życiu. Metoda lock() pozwala uzyskać tymczasowego współwłaściciela albo pusty std::shared_ptr, jeżeli własność już wygasła.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <memory>
std::weak_ptr<T> observer = owner;
if (auto held = observer.lock()) {
    // Access the object through held.
}

std::weak_ptr<T> z nagłówka <memory> przechowuje słabe odwołanie związane z własnością zarządzaną przez std::shared_ptr. Nie zwiększa liczby silnych właścicieli i nie przedłuża życia obiektu. Można go utworzyć z pasującego std::shared_ptr albo pozostawić pustym.

Nie udostępnia operatorów * ani ->. Wywołaj lock() i sprawdź zwrócony std::shared_ptr. Uzyskanie współwłasności jest atomowe: metoda zwraca współwłaściciela albo pusty wskaźnik, jeśli własność wygasła, i nie zgłasza wyjątków. Zachowaj wynik przez cały czas dostępu do obiektu.

expired() oznacza use_count() == 0; use_count() liczy silnych właścicieli, nie obserwatorów. Samo sprawdzenie expired() nie rezerwuje czasu życia: inny wątek może zwolnić ostatniego właściciela przed późniejszym lock(). Atomowość lock() nie synchronizuje dostępu do danych obiektu.

Słabe odwołanie przydaje się do obserwacji i przerywania cykli własności: połączenie zwrotne może używać std::weak_ptr zamiast kolejnego silnego właściciela. reset() opróżnia obserwatora bez niszczenia obserwowanego obiektu. Przykład używa funkcji dostępnych w C++23; podany bieżący szkic standardu zawiera także późniejsze rozszerzenia.

Przykłady

#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';
}

Wynik

42
true
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła