std::shared_ptr<T>::use_count - cppreference.com

long use_count() const noexcept;

返回管理当前对象的不同 shared_ptr 实例的数量（包括 *this）。没有管理的对象时会返回 0。

多线程环境中，use_count 原子地获得实例的数量（典型实现使用 std::memory_order_release 加载）。

返回值

管理当前对象的 std::shared_ptr 实例的数量，或在没有管理的对象时返回 0。

注解

常用用法包括：

• 与 0 比较。如果 use_count 返回 0，那么智能指针为空 且不管理对象（无论被存储指针是否为空）。多线程环境中，这不隐含被管理对象的析构函数已完成。
• 与 1 比较。如果 use_count 返回 1，那么就没有其他共享拥有者。被弃用的(C++17 起)成员函数 unique() 用于支持此用法。(C++20 前)

在多线程环境中，use_count 返回的值应被认做近似值，因为在原子地获取值，到有意义地使用值期间，共享拥有者的数量可能在其他线程中改变。当 use_count 返回 1 时，不隐含对象可以安全修改，因为先前拥有者对被管理对象的访问可能未完成，而新的共享拥有者可以在其他线程中创建，例如使用 std::weak_ptr::lock。只有当 use_count 返回 0 时，数量才是准确的。

示例

#include <iostream>
#include <memory>

void fun(std::shared_ptr<int> sp)
{
    std::cout << "在 fun() 中：sp.use_count() == " << sp.use_count()
              << "（对象在 " << sp << "）\n";
}

int main()
{
    auto sp1 = std::make_shared<int>(5);
    std::cout << "在 main() 中：sp1.use_count() == " << sp1.use_count()
              << "（对象在 " << sp1 << "）\n";

    fun(sp1);
}

在 main() 中：sp1.use_count() == 1（对象在 0x20eec30）
在 fun() 中：sp.use_count() == 2（对象在 0x20eec30）

参阅