std::shared_ptr::use_count

来自cppreference.com
< cpp‎ | memory‎ | shared ptr
 
 
工具库
类型支持(基本类型、 RTTI 、类型特性)
动态内存管理
错误处理
程序工具
变参数函数
日期和时间
函数对象
(C++11)
关系运算符
optionalanyvariant (C++17)
pair 与 tuple
(C++11)
(C++17)
swap 、 forward 与 move
(C++14)
(C++11)
(C++11)
初等字符串转换
(C++17)
(C++17)
类型运算
(C++11)
(C++17)
 
 
 
long use_count() const noexcept;

返回管理当前对象的不同 shared_ptr 实例(包含 this )数量。若无管理对象,则返回 0

多线程环境下, use_count 返回的值是近似的(典型实现使用 memory_order_relaxed 加载)

目录

[编辑] 参数

(无)

[编辑] 返回值

管理当前对象的 shared_ptr 实例数量,或若无被管理对象则为 0

[编辑] 注意

常用使用包括

  • 0 比较。若 use_count 返回零,则智能指针为且不管理对象(无论被存储指针是否为空)。多线程环境下,这不隐含被管理对象的析构函数已完成。
  • 1 比较。若 use_count 返回 1 ,则无其他拥有者。(被弃用成员函数 unique() 为此使用情况提供。)多线程环境中,这不隐含对象可以安全修改,因为先前拥有者对被管理对象的访问可能未完成,而因为新的共享拥有者可以同时引入,例如用 std::weak_ptr::lock

[编辑] 示例

#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

[编辑] 参阅

(弃用)
检查所管理对象是否仅由当前 shared_ptr 的实例管理
(公开成员函数) [编辑]