|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
weak_ptr::weak_ptr | ||||
| Modifiers | ||||
| Observers | ||||
(C++26) | ||||
(C++26) | ||||
| Non-member functions | ||||
| Helper classes | ||||
(C++20) | ||||
| Deduction guides(C++17) |
constexpr weak_ptr()noexcept; | (1) | (since C++11) |
weak_ptr(const weak_ptr& r)noexcept; | (2) | (since C++11) |
template<class Y> weak_ptr(const weak_ptr<Y>& r)noexcept; | (2) | (since C++11) |
template<class Y> weak_ptr(conststd::shared_ptr<Y>& r)noexcept; | (2) | (since C++11) |
weak_ptr( weak_ptr&& r)noexcept; | (3) | (since C++11) |
template<class Y> weak_ptr( weak_ptr<Y>&& r)noexcept; | (3) | (since C++11) |
Constructs newweak_ptr that potentially shares an object withr.
weak_ptr.weak_ptr which shares an object managed byr. Ifr manages no object,*this manages no object too. The templated overloads don't participate in the overload resolution unlessY* is implicitly convertible toT*, orY is the type "array ofNU" for some typeU and some numberN, andT is the type "array of unknown bound of (possibly cv-qualified)U"(since C++17).Y* is implicitly convertible toT*.Contents |
| r | - | astd::shared_ptr orstd::weak_ptr that will be viewed by thisstd::weak_ptr |
Because the default constructor isconstexpr, staticstd::weak_ptrs are initialized as part ofstatic non-local initialization, before any dynamic non-local initialization begins. This makes it safe to use astd::weak_ptr in a constructor of any static object.
#include <iostream>#include <memory> struct Foo{}; int main(){std::weak_ptr<Foo> w_ptr; {auto ptr=std::make_shared<Foo>(); w_ptr= ptr;std::cout<<"w_ptr.use_count() inside scope: "<< w_ptr.use_count()<<'\n';} std::cout<<"w_ptr.use_count() out of scope: "<< w_ptr.use_count()<<'\n';std::cout<<"w_ptr.expired() out of scope: "<<std::boolalpha<< w_ptr.expired()<<'\n';}
Output:
w_ptr.use_count() inside scope: 1w_ptr.use_count() out of scope: 0w_ptr.expired() out of scope: true
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2315 | C++11 | move semantic was not enabled forweak_ptr | enabled |
assigns theweak_ptr(public member function)[edit] |