std::weak_ptr

template< class T > class 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 указателей), счётчики ссылок 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++.

См. также