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

CKTIS / C++

std::weak_ptr — pozorování bez prodloužení životnosti objektu

std::weak_ptr<T> pozoruje objekt spravovaný pomocí std::shared_ptr, aniž by jej udržoval naživu. Metoda lock() dočasně získá sdíleného vlastníka, nebo vrátí prázdný std::shared_ptr, pokud vlastnictví již zaniklo.

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

Syntaxe

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

std::weak_ptr<T> z hlavičky <memory> uchovává slabý odkaz spojený s vlastnictvím spravovaným pomocí std::shared_ptr. Nezvyšuje počet silných vlastníků a neprodlužuje životnost objektu. Vytvořte jej z kompatibilního std::shared_ptr, nebo jej ponechte prázdný.

Nenabízí operátory * ani ->. Zavolejte lock() a zkontrolujte vrácený std::shared_ptr. Získání sdíleného vlastnictví je atomické: metoda vrátí sdíleného vlastníka, nebo prázdný ukazatel, pokud vlastnictví zaniklo, a nevyvolá výjimku. Výsledek uchovávejte po celou dobu přístupu k objektu.

expired() znamená use_count() == 0; use_count() počítá silné vlastníky, nikoli pozorovatele. Samotná kontrola expired() životnost nezajišťuje: jiné vlákno může uvolnit posledního vlastníka před pozdějším voláním lock(). Atomickost metody lock() nesynchronizuje přístup k datům objektu.

Slabé odkazy se hodí k pozorování a přerušování cyklů vlastnictví: zpětný odkaz může používat std::weak_ptr místo dalšího silného vlastníka. reset() vyprázdní pozorovatele, aniž by zničil pozorovaný objekt. Příklad používá funkce dostupné v C++23; dodaný aktuální pracovní návrh normy obsahuje také pozdější rozšíření.

Příklady

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

Výsledek

42
true
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