std:: weak_ptr

std::weak_ptr — это умный указатель, который содержит неуправляющую ("слабую") ссылку на объект, управляемый std::shared_ptr . Он должен быть преобразован в std::shared_ptr для доступа к ссылаемому объекту.

std::weak_ptr моделирует временное владение: когда объект должен быть доступен только если он существует, и он может быть удален в любой момент кем-то другим, std::weak_ptr используется для отслеживания объекта и преобразуется в std::shared_ptr для получения временного владения. Если исходный std::shared_ptr уничтожается в этот момент, время жизни объекта продлевается до тех пор, пока временный std::shared_ptr также не будет уничтожен.

Еще одно применение std::weak_ptr — разрыв циклических ссылок, образуемых объектами, управляемыми через std::shared_ptr . Если такой цикл оказывается изолированным (т.е. отсутствуют внешние shared_ptr, указывающие на цикл), счетчики ссылок shared_ptr не могут достичь нуля, и происходит утечка памяти. Чтобы предотвратить это, один из указателей в цикле можно сделать слабым .

Типы членов

Функции-члены

Функции, не являющиеся членами класса

Вспомогательные классы

Руководства по выводу (начиная с C++17)

Примечания

Как и std::shared_ptr , типичная реализация weak_ptr хранит два указателя:

• указатель на блок управления; и
• сохранённый указатель shared_ptr , из которого он был создан.

Отдельное сохранённое указание необходимо для обеспечения корректной работы преобразования shared_ptr в weak_ptr и обратно, даже для алиасированных shared_ptr . Невозможно получить доступ к сохранённому указанию в weak_ptr без блокировки его в shared_ptr .

Пример

#include <iostream>
#include <memory>
std::weak_ptr<int> gw;
void observe()
{
    std::cout << "gw.use_count() == " << gw.use_count() << "; ";
    // we have to make a copy of shared pointer before usage:
    if (std::shared_ptr<int> spt = gw.lock())
        std::cout << "*spt == " << *spt << '\n';
    else
        std::cout << "gw is expired\n";
}
int main()
{
    {
        auto sp = std::make_shared<int>(42);
        gw = sp;
        observe();
    }
    observe();
}

gw.use_count() == 1; *spt == 42
gw.use_count() == 0; gw is expired

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также