std::bad_weak_ptr

来自cppreference.com
< cpp‎ | memory
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
 
动态内存管理
智能指针
(C++11)
(C++11)
(C++11)
(C++17 前)
(C++11)
bad_weak_ptr
(C++11)
(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 前)
杂项
(C++20)
(C++11)
(C++11)
C 库
低层内存管理
 
定义于头文件 <memory>
class bad_weak_ptr;
(C++11 起)

std::bad_weak_ptrstd::shared_ptrstd::weak_ptr 为参数的构造函数,在 std::weak_ptr 指代已被删除的对象时,作为异常抛出的对象类型。

cpp/error/exceptionstd-bad weak ptr-inheritance.svg

继承图

成员函数

(构造函数)
构造新的 bad_weak_ptr 对象
(公开成员函数)
operator=
替换 bad_weak_ptr 对象
(公开成员函数)
what
返回解释字符串
(公开成员函数)

std::bad_weak_ptr::bad_weak_ptr

bad_weak_ptr() noexcept;
(1) (C++11 起)
bad_weak_ptr( const bad_weak_ptr& other ) noexcept;
(2) (C++11 起)

构造新的拥有实现定义的空终止字节字符串的 bad_weak_ptr 对象,字符串能通过 what() 访问。

1) 默认构造函数。
2) 复制构造函数。若 *thisother 均拥有动态类型 std::bad_weak_ptrstd::strcmp(what(), other.what()) == 0

参数

other - 要复制的另一异常对象

std::bad_weak_ptr::operator=

bad_weak_ptr& operator=( const bad_weak_ptr& other ) noexcept;
(C++11 起)

other 的内容赋值。若 *thisother 均拥有动态类型 std::bad_weak_ptr 则赋值后 std::strcmp(what(), other.what()) == 0

参数

other - 用以赋值的另一异常对象

返回值

*this

std::bad_weak_ptr::what

virtual const char* what() const noexcept;
(C++11 起)

返回解释字符串。

参数

(无)

返回值

指向有解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring 。保证该指针至少到获得它来源的异常对象被销毁,或在该异常对象上调用非 const 成员函数(例如复制赋值运算符)为止合法。

注解

允许但不要求实现覆写 what()

继承自 std::exception

成员函数

析构该异常对象
(std::exception 的虚公开成员函数)
[虚]
返回解释性字符串
(std::exception 的虚公开成员函数)

示例

#include <memory>
#include <iostream>
int main()
{
    std::shared_ptr<int> p1(new int(42));
    std::weak_ptr<int> wp(p1);
    p1.reset();
    try {
        std::shared_ptr<int> p2(wp);
    } catch(const std::bad_weak_ptr& e) {
        std::cout << e.what() << '\n';
    }
}

可能的输出:

std::bad_weak_ptr

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
LWG 2376 C++11 要求在默认构造的 bad_weak_ptr 上调用 what 返回 "bad_weak_ptr" 返回值为实现定义

参阅

拥有共享对象所有权语义的智能指针
(类模板)
(C++11)
std::shared_ptr 所管理对象的弱引用
(类模板)