SysTutorials

Linux Manual Pages › Section 3

stdweak_ptr(3)

std::weak_ptr - std::weak_ptr

Synopsis

Defined in header <memory> template< class T > class weak_ptr; (since C++11) std::weak_ptr is a smart pointer that holds a non-owning ("weak") reference to an object that is managed by std::shared_ptr. It must be converted to std::shared_ptr in order to access the referenced object. std::weak_ptr models temporary ownership: when an object needs to be accessed only if it exists, and it may be deleted at any time by someone else, std::weak_ptr is used to track the object, and it is converted to std::shared_ptr to assume temporary ownership. If the original std::shared_ptr is destroyed at this time, the object’s lifetime is extended until the temporary std::shared_ptr is destroyed as well. Another use for std::weak_ptr is to break reference cycles formed by objects managed by std::shared_ptr. If such cycle is orphaned (i,e. there are no outside shared pointers into the cycle), the shared_ptr reference counts cannot reach zero and the memory is leaked. To prevent this, one of the pointers in the cycle can be made weak.

Member types

Member type Definition

element_type T (until C++17)              std::remove_extent_t<T> (since C++17)

Member functions

              creates a new weak_ptr constructor (public member function)               destroys a weak_ptr destructor (public member function)               assigns the weak_ptr operator= (public member function)

Modifiers

              releases the ownership of the managed object reset (public member function)               swaps the managed objects swap (public member function)

Observers

              returns the number of shared_ptr objects that manage the object use_count (public member function)               checks whether the referenced object was already deleted expired (public member function)               creates a shared_ptr that manages the referenced object lock (public member function)               provides owner-based ordering of weak pointers owner_before (public member function)

Non-member functions

std::swap(std::weak_ptr) specializes the std::swap algorithm                          (function template) (C++11)

Helper classes

std::atomic<std::weak_ptr> atomic weak pointer                            (class template specialization) (C++20)

Deduction_guides(since C++17)

Notes

Like std::shared_ptr, a typical implementation of weak_ptr stores two pointers:

Example

Demonstrates how lock is used to ensure validity of the pointer. // Run this code

#include <iostream>
#include <memory>
std::weak_ptr<int> gw;
void observe()
{
std::cout << "use_count == " << gw.use_count() << ": ";
if (auto spt = gw.lock()) { // Has to be copied into a shared_ptr before usage
std::cout << *spt << "\n";
} else {
std::cout << "gw is expired\n";
}
}
int main()
{
{
auto sp = std::make_shared<int>(42);
gw = sp;
observe();
}
observe();
}

Output:

  use_count == 1: 42   use_count == 0: gw is expired