std::shared_ptr::use_count

long use_count() const;

Returns the number of different shared_ptr instances (this included) managing the current object. If there is no managed object, ​0​ is returned.

Parameters

(none).

Return value

the number of shared_ptr instances managing the current object or ​0​ if there is no managed object.

Exceptions

Example

#include <memory> 
#include <iostream> 
 
void fun(std::shared_ptr<int> sp)
{
    std::cout << "fun: sp.use_count() == " << sp.use_count() << '\n'; 
}
 
int main() 
{ 
    auto sp1 = std::make_shared<int>(5);
    std::cout << "sp1.use_count() == " << sp1.use_count() << '\n'; 
 
    fun(sp1);
}

sp1.use_count() == 1
fun: sp.use_count() == 2

See also