long use_count() const noexcept;
Returns the number of different
shared_ptr instances (this included) managing the current object. If there is no managed object, 0 is returned.
In multithreaded environment, the value returned by use_count is approximate (typical implementations use a memory_order_relaxed load)
the number of
shared_ptr instances managing the current object or 0 if there is no managed object.
Common use cases include
- comparison with 0. If
use_countreturns zero, the shared pointer is empty and manages no objects (whether or not its stored pointer is null). In multithreaded environment, this does not imply that the destructor of the managed object has completed.
- comparison with 1. If
use_countreturns 1, there are no other owners. (The deprecated member function unique() is provided for this use case.) In multithreaded environment, this does not imply that the object is safe to modify because accesses to the managed object by former shared owners may not have completed, and because new shared owners may be introduced concurrently, such as by std::weak_ptr::lock.
sp1.use_count() == 1 fun: sp.use_count() == 2
| checks whether the managed object is managed only by the current |
(public member function)