std::shared_ptr<T>::use_count

来自cppreference.com
< cpp‎ | memory‎ | shared ptr
 
C++
 
内存管理库
(仅用于阐述*)
分配器
未初始化内存算法
受约束的未初始化内存算法
内存资源
未初始化存储 (C++20 前)
(C++17 弃用)
(C++17 弃用)
(C++17 弃用)

垃圾收集器支持 (C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
(C++11)(C++23 前)
 
std::shared_ptr
成员函数
修改器
观察器
(C++17)
shared_ptr::use_count
(C++20 前*)
(C++26)
(C++26)
非成员函数
(C++20)
(C++20)
(C++17)
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
函数 (C++26 前*)
辅助类
(C++20)
推导指引(C++17)
 
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 << "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)

[编辑] 参阅

(C++20 前)
 检查所管理对象是否仅由当前 shared_ptr 的对象管理
(公开成员函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/memory/shared_ptr/use_count&oldid=93248”