std::shared_ptr<T>::use_count
来自 cppreference.cn
< cpp | 内存 | shared ptr
| long use_count() const noexcept; |
||
返回管理当前对象的不同 shared_ptr 实例（包含 *this）的数量。若无被管理的对象，则返回 0。
在多线程环境中，use_count 原子地获取实例数量（典型实现使用 memory_order_relaxed 加载）。
目录 |
[编辑] 参数
(无)
[编辑] 返回值
管理当前对象的 std::shared_ptr 实例的数量，若无被管理的对象则为 0。
[编辑] 注意
常见用例包括
- 与 0 比较。若
use_count返回零，则共享指针是空的且不管理对象（不论其存储的指针是否为 nullptr）。 - 与 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 对象管理(公开成员函数) |
