C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- std::addressof
- std::allocator_traits
- std::weak_ptr
- std::unique_ptr
- std::scoped_allocator_adaptor
- std::auto_ptr
- std::destroy_at
- std::destroy
- std::destroy_n
- std::uninitialized_move
- std::uninitialized_value_construct
- std::owner_less
- std::shared_ptr
- std::to_address
- std::assume_aligned
- std::make_obj_using_allocator
- C 内存管理库
- 低层内存管理
- std::pmr::memory_resource
- std::allocator
- std::pointer_traits
- std::atomic(std::weak_ptr)
- std::default_delete
- std::allocator_arg_t
- std::allocator_arg
- std::enable_shared_from_this
- std::bad_weak_ptr
- std::uses_allocator
- std::uses_allocator_construction_args
- std::uninitialized_construct_using_allocator
- std::pmr::polymorphic_allocator
- std::pmr::get_default_resource
- std::pmr::set_default_resource
- std::pmr::new_delete_resource
- std::pmr::null_memory_resource
- std::pmr::synchronized_pool_resource
- std::pmr::unsynchronized_pool_resource
- std::pmr::monotonic_buffer_resource
- std::pmr::pool_options
- std::raw_storage_iterator
- std::get_temporary_buffer
- std::return_temporary_buffer
- std::uninitialized_copy
- std::uninitialized_fill
- std::uninitialized_default_construct
- std::uninitialized_copy_n
- std::uninitialized_fill_n
- std::uninitialized_move_n
- std::uninitialized_default_construct_n
- std::uninitialized_value_construct_n
- std::construct_at
- std::align
- 注释
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::weak_ptr
定义于头文件 <memory>
|
||
template< class T > class weak_ptr; |
(C++11 起) | |
std::weak_ptr
是一种智能指针,它对被 std::shared_ptr 管理的对象存在非拥有性(「弱」)引用。在访问所引用的对象前必须先转换为 std::shared_ptr。
std::weak_ptr
用来表达临时所有权的概念:当某个对象只有存在时才需要被访问,而且随时可能被他人删除时,可以使用 std::weak_ptr
来跟踪该对象。需要获得临时所有权时,则将其转换为 std::shared_ptr,此时如果原来的 std::shared_ptr 被销毁,则该对象的生命期将被延长至这个临时的 std::shared_ptr 同样被销毁为止。
std::weak_ptr 的另一用法是打断 std::shared_ptr 所管理的对象组成的环状引用。若这种环被孤立(例如无指向环中的外部共享指针),则 shared_ptr
引用计数无法抵达零,而内存被泄露。能令环中的指针之一为弱指针以避免此情况。
成员类型
成员类型 | 定义 | ||||
element_type |
|
成员函数
构造新的weak_ptr (公开成员函数) | |
销毁 weak_ptr (公开成员函数) | |
为weak_ptr 赋值 (公开成员函数) | |
修改器 | |
释放被管理对象的所有权 (公开成员函数) | |
交换被管理对象 (公开成员函数) | |
观察器 | |
返回管理该对象的 shared_ptr 对象数量 (公开成员函数) | |
检查被引用的对象是否已删除 (公开成员函数) | |
创建管理被引用的对象的shared_ptr (公开成员函数) | |
提供弱指针的基于拥有者顺序 (公开成员函数) |
非成员函数
(C++11) |
特化 std::swap 算法 (函数模板) |
辅助类
(C++20) |
原子弱指针 (类模板特化) |
推导指引(C++17 起)
注意
同 std::shared_ptr , weak_ptr
的典型实现存储二个指针:
- 指向控制块的指针;和
- 作为构造来源的
shared_ptr
的存储指针。
需要用分离的存储指针确保 shared_ptr
和 weak_ptr
间的来回转化正确进行,即使对于别名使用的 shared_ptr
。不可能不经将 weak_ptr
中的存储指针锁入 shared_ptr
就访问它。
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
LWG 3001 | C++17 | 未为数组支持更新 element_type
|
已更新 |
示例
演示如何通过锁来保证指针的有效性
运行此代码
#include <iostream> #include <memory> std::weak_ptr<int> gw; void f() { if (auto spt = gw.lock()) { // 使用之前必须复制到 shared_ptr std::cout << *spt << "\n"; } else { std::cout << "gw is expired\n"; } } int main() { { auto sp = std::make_shared<int>(42); gw = sp; f(); } f(); }
输出:
42 gw is expired