std::shared_ptr<T>::use_count

声明

long use_count() const noexcept;

返回管理当前对象的不同 shared_ptr 实例（包括此实例）的数量。如果不存在被管理对象，则返回 0。

在多线程环境中，use_count 返回的值是近似的（典型实现使用 memory_order_relaxed 加载）。

参数

(无)

返回值

管理当前对象的 std::shared_ptr 实例的数量，或者如果不存在被管理对象则为 0。

备注

常见用例包括

• 与 0 进行比较。如果 use_count 返回 0，则共享指针为空，不管理任何对象（无论其存储的指针是否为 nullptr）。
• 与 1 进行比较。如果 use_count 返回 1，则没有其他所有者。已弃用（自 C++17 起）的成员函数 unique() 为此用例提供（直到 C++20）。在多线程环境中，这并不意味着对象可以安全修改，因为先前共享所有者的对被管理对象的访问可能尚未完成，并且因为并发引入了新的共享所有者，例如通过 std::weak_ptr::lock。

示例

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

可能结果

in main(): sp1.use_count() == 1 (object @ 0x20eec30)
in fun(): sp.use_count() == 2 (object @ 0x20eec30)