• 文件浏览器
  • 001 《C++语言纲要:从入门到精通》 002 《C++ 整数类型深度解析:从基础到高级》 003 《C++ 字符类型深度解析:从入门到精通 (C++ Character Types: In-depth Analysis from Beginner to Expert)》 004 《C++ 浮点类型深度解析 (In-Depth Analysis of C++ Floating-Point Types)》 005 《深入理解C++布尔类型(A Deep Dive into C++ Boolean Type)》 006 《C++ 空类型 (Void Type) 深度解析:从基础到高级应用》 007 《C++ nullptr_t 类型全面深度解析》 008 《C++ auto 类型深度解析:从入门到精通 (In-depth Analysis of C++ auto Type: From Beginner to Expert)》 009 《C++原始指针(Raw Pointer)深度解析》 010 《C++ 数组 (Array) 全面深度解析》 011 《C++ 引用类型 (Reference Type) 深度解析》 012 《C++ std::string 全面深度解析与实践》 013 《深入探索 folly::string:高效字符串处理的艺术与实践》 014 《C++ unique_ptr 深度解析:从入门到精通》 015 《C++ shared_ptr 深度解析:原理、应用与最佳实践 (C++ shared_ptr Deep Dive: Principles, Applications, and Best Practices)》 016 《C++ weak_ptr 深度解析:原理、应用与最佳实践》 017 《C++ 函数深度解析 (Deep Dive into C++ Functions)》 018 《C++ 枚举类型 (enum 和 enum class) 全面深度解析》 019 《C++ Union 类型全面深度解析》 020 《C++ 结构体 (struct) 全面深度解析》 021 《C++ 类全面深度解析》 022 《C++ 面向对象技术深度解析与实践》 023 《C++设计模式:原理、实践与现代应用》 024 《C++关键词深度解析:从基础到现代C++》

    016 《C++ weak_ptr 深度解析:原理、应用与最佳实践》


    作者Lou Xiao, gemini创建时间2025-04-22 20:18:45更新时间2025-04-22 20:18:45

    🌟🌟🌟本文由Gemini 2.0 Flash Thinking Experimental 01-21生成,用来辅助学习。🌟🌟🌟

    书籍大纲

    ▮▮ 1. 智能指针与内存管理 (Smart Pointers and Memory Management)概述
    ▮▮▮▮ 1.1 C++ 内存管理的历史与挑战 (History and Challenges of Memory Management in C++)
    ▮▮▮▮▮▮ 1.1.1 手动内存管理的陷阱 (Pitfalls of Manual Memory Management)
    ▮▮▮▮▮▮ 1.1.2 RAII (Resource Acquisition Is Initialization) 原则 (RAII Principle)
    ▮▮▮▮ 1.2 智能指针的诞生与分类 (Birth and Classification of Smart Pointers)
    ▮▮▮▮▮▮ 1.2.1 unique_ptr (独占指针):独占所有权 (Exclusive Ownership)
    ▮▮▮▮▮▮ 1.2.2 shared_ptr (共享指针):共享所有权 (Shared Ownership)与引用计数 (Reference Counting)
    ▮▮▮▮▮▮ 1.2.3 weak_ptr (弱指针):非拥有性观察者 (Non-owning Observer)
    ▮▮▮▮ 1.3 为什么需要 weak_ptr (Why weak_ptr is Necessary)
    ▮▮▮▮▮▮ 1.3.1 循环引用问题 (Circular Dependency Problem)详解
    ▮▮▮▮▮▮ 1.3.2 weak_ptr 在打破循环引用中的作用 (The Role of weak_ptr in Breaking Circular Dependencies)
    ▮▮ 2. weak_ptr 的原理与机制 (Principles and Mechanisms of weak_ptr)
    ▮▮▮▮ 2.1 weak_ptr 的内部结构 (Internal Structure of weak_ptr)
    ▮▮▮▮ 2.2 weak_ptr 的状态:有效与过期 (States of weak_ptr: Valid and Expired)
    ▮▮▮▮ 2.3 weak_ptr 的关键操作:lock() (Key Operations of weak_ptr: lock())
    ▮▮▮▮ 2.4 weak_ptr 的其他操作:expired()、reset()、use_count() (Other Operations of weak_ptr: expired(), reset(), use_count())
    ▮▮ 3. weak_ptr 的应用场景 (Application Scenarios of weak_ptr)
    ▮▮▮▮ 3.1 解决循环引用 (Resolving Circular Dependencies)的经典案例
    ▮▮▮▮▮▮ 3.1.1 父子节点关系 (Parent-Child Relationship)的树形结构
    ▮▮▮▮▮▮ 3.1.2 双向关联的对象 (Bidirectional Associated Objects)
    ▮▮▮▮ 3.2 对象观察者 (Object Observer)模式
    ▮▮▮▮▮▮ 3.2.1 事件回调 (Event Callback)机制
    ▮▮▮▮▮▮ 3.2.2 缓存 (Cache)机制
    ▮▮▮▮ 3.3 工厂模式与对象生命周期管理 (Factory Pattern and Object Lifecycle Management)
    ▮▮ 4. weak_ptr 与线程安全 (Thread Safety of weak_ptr)
    ▮▮▮▮ 4.1 weak_ptr 的线程安全级别 (Thread Safety Level of weak_ptr)
    ▮▮▮▮ 4.2 多线程环境下的 weak_ptr 使用注意事项 (Precautions for Using weak_ptr in Multithreaded Environments)
    ▮▮ 5. weak_ptr 的高级主题与最佳实践 (Advanced Topics and Best Practices of weak_ptr)
    ▮▮▮▮ 5.1 enable_shared_from_this 与 weak_ptr 的配合使用 (Using enable_shared_from_this with weak_ptr)
    ▮▮▮▮ 5.2 自定义删除器 (Custom Deleter)与 weak_ptr 的关系 (Relationship between Custom Deleter and weak_ptr)
    ▮▮▮▮ 5.3 性能考量 (Performance Considerations)与 weak_ptr 的选择
    ▮▮▮▮ 5.4 weak_ptr 的最佳实践与常见误区 (Best Practices and Common Pitfalls of weak_ptr)
    ▮▮▮▮▮▮ 5.4.1 何时使用 weak_ptr (When to Use weak_ptr)
    ▮▮▮▮▮▮ 5.4.2 避免 dangling weak_ptr (Avoiding Dangling weak_ptr)
    ▮▮ 6. 案例分析:使用 weak_ptr 构建复杂系统 (Case Study: Building Complex Systems with weak_ptr)
    ▮▮▮▮ 6.1 案例背景:一个图形编辑器 (Case Background: A Graphics Editor)
    ▮▮▮▮ 6.2 系统设计与 weak_ptr 的应用 (System Design and Application of weak_ptr)
    ▮▮▮▮ 6.3 代码实现与分析 (Code Implementation and Analysis)
    ▮▮ 附录A: C++ 智能指针相关标准文档 (Standard Documents for C++ Smart Pointers)
    ▮▮ 附录B: 常用工具与调试技巧 (Common Tools and Debugging Techniques)
    ▮▮ 附录C: 术语表 (Glossary)
    ▮▮ 附录D: 参考文献 (References)


    1. 智能指针与内存管理 (Smart Pointers and Memory Management)概述

    1.1 C++ 内存管理的历史与挑战 (History and Challenges of Memory Management in C++)

    本节将回顾 C++ 早期以及现代 C++ 中内存管理的发展历程,并深入探讨手动内存管理所面临的挑战。理解这些挑战是认识智能指针,特别是 weak_ptr (弱指针),价值的基础。

    1.1.1 手动内存管理的陷阱 (Pitfalls of Manual Memory Management)

    在 C++ 的早期,程序员主要依赖手动内存管理,即使用 new 运算符来分配内存,并使用 delete 运算符来释放内存。这种方式赋予了程序员极大的灵活性,但也带来了许多潜在的风险,稍有不慎就可能导致程序出现各种难以调试的错误。手动内存管理主要的陷阱包括:

    内存泄漏 (Memory Leak)
    内存泄漏是最常见也是最难排查的内存管理问题之一。当使用 new 分配的内存没有被及时使用 delete 释放时,就会发生内存泄漏。随着程序运行时间的增长,泄漏的内存会不断累积,最终可能导致系统资源耗尽,程序崩溃,甚至影响到整个操作系统。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 void memoryLeakExample() {
    2 int* ptr = new int[100]; // 分配了 100 个 int 大小的内存
    3 // ... 假设这里有一些操作,但是忘记释放内存了
    4 // delete[] ptr; // 忘记释放内存,造成内存泄漏
    5 }

    上述代码片段中,使用 new int[100] 分配了一块内存,但函数结束前忘记使用 delete[] ptr 来释放这块内存。每次调用 memoryLeakExample() 函数都会泄漏 100 个 int 大小的内存。

    悬挂指针 (Dangling Pointer)
    悬挂指针指的是指向已经被释放的内存区域的指针。当程序尝试访问悬挂指针所指向的内存时,由于该内存可能已经被系统回收或重新分配给其他用途,这会导致不可预测的行为,例如程序崩溃、数据损坏或者安全漏洞。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 int* danglingPointerExample() {
    2 int* ptr = new int;
    3 *ptr = 10;
    4 int* danglingPtr = ptr;
    5 delete ptr; // ptr 指向的内存被释放
    6 return danglingPtr; // danglingPtr 成为了悬挂指针
    7 }
    8
    9 void accessDanglingPointer() {
    10 int* dp = danglingPointerExample();
    11 // 尝试访问悬挂指针,行为未定义,可能崩溃或产生其他错误
    12 // std::cout << *dp << std::endl; // 潜在的错误
    13 }

    danglingPointerExample() 函数中,ptr 指向的内存被释放后,danglingPtr 仍然指向原来的内存地址,此时 danglingPtr 就变成了悬挂指针。在 accessDanglingPointer() 中尝试解引用 dp (即 danglingPtr),会导致未定义行为。

    重复释放 (Double Free)
    重复释放指的是对同一块内存区域多次使用 delete 运算符进行释放。这通常发生在程序逻辑错误的情况下,例如多个指针指向同一块内存,并且都尝试释放这块内存。重复释放会导致内存管理器的内部数据结构损坏,进而引发程序崩溃或其他更严重的问题。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 void doubleFreeExample() {
    2 int* ptr1 = new int;
    3 int* ptr2 = ptr1; // ptr1 和 ptr2 指向同一块内存
    4 delete ptr1; // 第一次释放
    5 // ...
    6 delete ptr2; // 第二次释放,造成重复释放错误
    7 }

    doubleFreeExample() 函数中,ptr1ptr2 指向同一块内存。第一次 delete ptr1 释放了内存后,ptr2 仍然指向这块已经被释放的内存。再次 delete ptr2 就会导致重复释放错误。

    野指针 (Wild Pointer)
    野指针是指在声明时没有被初始化的指针。由于指针变量在声明时其值是随机的,野指针会指向内存中的任意位置。如果程序错误地解引用野指针,可能会访问到未知的内存区域,导致程序行为异常。虽然野指针和悬挂指针都指向无效的内存,但野指针通常指的是未初始化或指向未知区域的指针,而悬挂指针则特指指向已释放内存的指针。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 int* wildPointerExample() {
    2 int* wildPtr; // wildPtr 未初始化,成为野指针
    3 // ...
    4 return wildPtr; // 返回野指针
    5 }
    6
    7 void accessWildPointer() {
    8 int* wp = wildPointerExample();
    9 // 尝试访问野指针,行为未定义,非常危险
    10 // *wp = 20; // 潜在的错误
    11 }

    wildPointerExample() 函数中,wildPtr 在声明时没有被初始化,它可能指向内存中的任意位置。在 accessWildPointer() 中尝试访问或修改 wp 指向的内存是非常危险的。

    为了应对手动内存管理带来的种种陷阱,现代 C++ 引入了 RAII (Resource Acquisition Is Initialization) 原则和智能指针 (Smart Pointer)

    1.1.2 RAII (Resource Acquisition Is Initialization) 原则 (RAII Principle)

    RAII (Resource Acquisition Is Initialization),即资源获取即初始化,是 C++ 中管理资源(包括内存、文件句柄、锁等)的一种核心设计原则。RAII 的核心思想是将资源的生命周期与对象的生命周期绑定在一起。具体来说,就是在对象创建时获取资源(初始化),在对象销毁时释放资源(析构)。通过这种方式,资源的释放可以得到保证,即使在发生异常的情况下也能确保资源被正确释放,从而避免资源泄漏等问题。

    RAII 原则的关键在于构造函数 (Constructor)析构函数 (Destructor) 的作用:

    构造函数 (Constructor):负责资源的获取和初始化。当对象被创建时,构造函数会被自动调用,在构造函数内部,可以完成资源的分配和初始化操作。例如,对于管理动态内存的 RAII 类,其构造函数中会使用 new 分配内存。
    析构函数 (Destructor):负责资源的释放和清理。当对象生命周期结束时(例如,对象超出作用域、被显式删除等),析构函数会被自动调用。在析构函数内部,应该完成资源的释放操作。例如,对于管理动态内存的 RAII 类,其析构函数中会使用 delete 释放内存。

    RAII 原则的优点

    自动化资源管理:资源的获取和释放与对象的生命周期绑定,无需显式手动释放,降低了资源管理的出错概率。
    异常安全 (Exception Safety):即使在构造函数或程序执行过程中抛出异常,已经构造完成的对象的析构函数仍然会被调用,从而保证已经获取的资源得到释放,避免资源泄漏。
    代码简洁性和可维护性:RAII 可以将资源管理的代码封装在类的构造函数和析构函数中,使得代码更加简洁、清晰,提高了代码的可维护性。

    RAII 原则的示例
    以下是一个使用 RAII 原则管理动态分配的 int 数组的简单示例:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2
    3 class IntArray {
    4 private:
    5 int* data;
    6 size_t size;
    7
    8 public:
    9 // 构造函数:获取资源(分配内存)并初始化
    10 IntArray(size_t size) : size(size) {
    11 std::cout << "IntArray 构造函数被调用,分配内存..." << std::endl;
    12 data = new int[size];
    13 for (size_t i = 0; i < size; ++i) {
    14 data[i] = 0; // 初始化数组元素
    15 }
    16 }
    17
    18 // 析构函数:释放资源(释放内存)
    19 ~IntArray() {
    20 std::cout << "IntArray 析构函数被调用,释放内存..." << std::endl;
    21 delete[] data;
    22 data = nullptr; // 避免悬挂指针
    23 size = 0;
    24 }
    25
    26 int& operator[](size_t index) {
    27 if (index >= size) {
    28 throw std::out_of_range("索引越界");
    29 }
    30 return data[index];
    31 }
    32
    33 size_t getSize() const {
    34 return size;
    35 }
    36 };
    37
    38 void testRAII() {
    39 { // 引入一个代码块,限制 intArray 的作用域
    40 IntArray intArray(5); // 创建 IntArray 对象,构造函数分配内存
    41 intArray[0] = 1;
    42 intArray[1] = 2;
    43 // ... 使用 intArray
    44 std::cout << "intArray 的大小: " << intArray.getSize() << std::endl;
    45 } // intArray 对象生命周期结束,析构函数自动释放内存
    46 std::cout << "intArray 对象的作用域已结束" << std::endl;
    47 }
    48
    49 int main() {
    50 testRAII();
    51 return 0;
    52 }

    IntArray 类中,构造函数 IntArray(size_t size) 负责分配 int 数组的内存,析构函数 ~IntArray() 负责释放这块内存。当 testRAII() 函数中的 intArray 对象超出作用域时,其析构函数会自动被调用,从而确保分配的内存得到释放。即使在 IntArray 的使用过程中发生异常,只要对象构造成功,其析构函数最终都会被调用,保证了内存资源的安全性。

    RAII 原则是现代 C++ 编程的基础,智能指针正是 RAII 原则的一种典型应用。通过智能指针,C++ 可以更好地管理动态内存,避免手动内存管理的各种问题。

    1.2 智能指针的诞生与分类 (Birth and Classification of Smart Pointers)

    为了更好地解决手动内存管理的缺陷,并充分利用 RAII 原则,C++ 引入了智能指针 (Smart Pointer) 的概念。智能指针本质上是封装了原始指针的对象,它在内部自动管理所指向的内存,从而避免了内存泄漏和悬挂指针等问题。智能指针通过 RAII 原则,在智能指针对象自身生命周期结束时,自动释放其所管理的内存。

    C++11 标准库引入了三种主要的智能指针类型,它们都定义在 <memory> 头文件中:

    unique_ptr (独占指针)
    shared_ptr (共享指针)
    weak_ptr (弱指针)

    这三种智能指针在所有权语义、使用场景和内部实现机制上各有不同,它们共同构成了 C++ 现代内存管理的重要组成部分。

    1.2.1 unique_ptr (独占指针):独占所有权 (Exclusive Ownership)

    unique_ptr (独占指针) 提供独占所有权语义。这意味着一个 unique_ptr 对象独占地拥有它所指向的对象,同一时间只能有一个 unique_ptr 指向特定的对象。当 unique_ptr 对象被销毁时,它所指向的对象也会被自动删除。unique_ptr 非常轻量级,其大小通常与原始指针相同,并且在运行时几乎没有额外的性能开销。

    unique_ptr 的特点

    独占所有权:明确表达了所有权的唯一性,避免了所有权不明确导致的问题。
    不可复制,可移动unique_ptr 对象不可复制 (copyable),即不能使用拷贝构造函数和拷贝赋值运算符。这是为了保证独占所有权语义。但是,unique_ptr 对象可移动 (movable),可以使用移动构造函数和移动赋值运算符将所有权从一个 unique_ptr 转移到另一个 unique_ptr
    自动释放资源:当 unique_ptr 对象生命周期结束时,会自动调用 delete 释放所管理的内存,无需手动释放。
    支持自定义删除器 (Custom Deleter):可以指定自定义的删除器,用于在 unique_ptr 销毁时执行特定的资源释放操作,例如释放非 new 分配的内存或关闭文件句柄等。

    unique_ptr 的使用示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 void testUniquePtr() {
    5 // 使用 make_unique 创建 unique_ptr (推荐方式,更安全且可能更高效)
    6 std::unique_ptr<int> ptr1 = std::make_unique<int>(10);
    7 std::cout << "*ptr1: " << *ptr1 << std::endl; // 输出 *ptr1: 10
    8
    9 // 所有权转移:使用 std::move
    10 std::unique_ptr<int> ptr2 = std::move(ptr1);
    11 // std::cout << "*ptr1: " << *ptr1 << std::endl; // 错误!ptr1 已经失去了所有权,变为 nullptr
    12 std::cout << "*ptr2: " << *ptr2 << std::endl; // 输出 *ptr2: 10
    13 std::cout << "ptr1 是否为空: " << (ptr1 == nullptr) << std::endl; // 输出 ptr1 是否为空: 1
    14
    15 // unique_ptr 超出作用域时,自动释放内存
    16 }
    17
    18 // 使用 unique_ptr 管理动态数组
    19 void testUniquePtrArray() {
    20 std::unique_ptr<int[]> arrayPtr = std::make_unique<int[]>(5); // 注意使用 int[]
    21 for (int i = 0; i < 5; ++i) {
    22 arrayPtr[i] = i * 2;
    23 }
    24 for (int i = 0; i < 5; ++i) {
    25 std::cout << arrayPtr[i] << " "; // 输出 0 2 4 6 8
    26 }
    27 std::cout << std::endl;
    28 }
    29
    30 // 使用自定义删除器
    31 void testUniquePtrCustomDeleter() {
    32 // 假设有一个自定义的资源释放函数
    33 auto customDeleter = [](int* p) {
    34 std::cout << "自定义删除器被调用,释放内存..." << std::endl;
    35 delete p;
    36 };
    37
    38 std::unique_ptr<int, decltype(customDeleter)> ptr(new int(20), customDeleter);
    39 std::cout << "*ptr: " << *ptr << std::endl; // 输出 *ptr: 20
    40 // ptr 超出作用域时,customDeleter 会被调用
    41 }
    42
    43
    44 int main() {
    45 testUniquePtr();
    46 testUniquePtrArray();
    47 testUniquePtrCustomDeleter();
    48 return 0;
    49 }

    在上述示例中,unique_ptr 通过 std::make_unique 创建,保证了异常安全。所有权的转移通过 std::move 实现,体现了 unique_ptr 的独占性。unique_ptr 对象超出作用域时,会自动释放所管理的内存。对于动态数组,需要使用 std::unique_ptr<int[]> 来管理,并使用 std::make_unique<int[]>(size) 创建。自定义删除器允许用户灵活地定义资源释放的方式。

    unique_ptr 适用于明确对象所有权且不需要共享所有权的场景,是现代 C++ 中管理动态内存的首选智能指针之一。

    1.2.2 shared_ptr (共享指针):共享所有权 (Shared Ownership)与引用计数 (Reference Counting)

    shared_ptr (共享指针) 提供共享所有权语义。多个 shared_ptr 对象可以共享同一个对象的所有权。shared_ptr 使用引用计数 (Reference Counting) 来跟踪有多少个 shared_ptr 共同指向同一个对象。当最后一个指向该对象的 shared_ptr 被销毁时,即引用计数降为零时,shared_ptr 会自动删除所指向的对象。

    shared_ptr 的特点

    共享所有权:允许多个 shared_ptr 对象共同管理同一个对象的生命周期,适用于对象需要在多个组件之间共享的场景。
    引用计数:内部维护一个引用计数器,记录指向共享对象的 shared_ptr 数量。引用计数的变化是线程安全的(增加和减少操作是原子性的)。
    自动释放资源:当引用计数降为零时,会自动释放所管理的内存。
    可复制和可赋值shared_ptr 对象可复制 (copyable) 和 可赋值 (assignable)。复制或赋值操作会增加引用计数。
    支持自定义删除器 (Custom Deleter):类似于 unique_ptrshared_ptr 也支持自定义删除器。

    shared_ptr 的使用示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 void testSharedPtr() {
    5 // 使用 make_shared 创建 shared_ptr (推荐方式,更高效)
    6 std::shared_ptr<int> ptr1 = std::make_shared<int>(30);
    7 std::cout << "ptr1 的引用计数: " << ptr1.use_count() << std::endl; // 输出 ptr1 的引用计数: 1
    8 std::cout << "*ptr1: " << *ptr1 << std::endl; // 输出 *ptr1: 30
    9
    10 // 拷贝 shared_ptr,引用计数增加
    11 std::shared_ptr<int> ptr2 = ptr1;
    12 std::cout << "ptr1 的引用计数: " << ptr1.use_count() << std::endl; // 输出 ptr1 的引用计数: 2
    13 std::cout << "ptr2 的引用计数: " << ptr2.use_count() << std::endl; // 输出 ptr2 的引用计数: 2
    14 std::cout << "*ptr2: " << *ptr2 << std::endl; // 输出 *ptr2: 30
    15
    16 { // 引入代码块限制 ptr3 的作用域
    17 std::shared_ptr<int> ptr3 = ptr1;
    18 std::cout << "ptr1 的引用计数: " << ptr1.use_count() << std::endl; // 输出 ptr1 的引用计数: 3
    19 std::cout << "ptr3 的引用计数: " << ptr3.use_count() << std::endl; // 输出 ptr3 的引用计数: 3
    20 } // ptr3 超出作用域,析构,引用计数减少
    21
    22 std::cout << "ptr1 的引用计数: " << ptr1.use_count() << std::endl; // 输出 ptr1 的引用计数: 2
    23 std::cout << "ptr2 的引用计数: " << ptr2.use_count() << std::endl; // 输出 ptr2 的引用计数: 2
    24
    25 ptr2.reset(); // 显式释放 ptr2 的所有权,引用计数减少
    26 std::cout << "ptr1 的引用计数: " << ptr1.use_count() << std::endl; // 输出 ptr1 的引用计数: 1
    27 std::cout << "ptr2 的引用计数: " << ptr2.use_count() << std::endl; // 输出 ptr2 的引用计数: 0 (ptr2 变为空指针)
    28 std::cout << "ptr2 是否为空: " << (ptr2 == nullptr) << std::endl; // 输出 ptr2 是否为空: 1
    29 }
    30
    31 // 使用 shared_ptr 管理自定义类型对象
    32 class MyClass {
    33 public:
    34 MyClass(int value) : value_(value) {
    35 std::cout << "MyClass 构造函数被调用,value = " << value_ << std::endl;
    36 }
    37 ~MyClass() {
    38 std::cout << "MyClass 析构函数被调用,value = " << value_ << std::endl;
    39 }
    40 int getValue() const { return value_; }
    41 private:
    42 int value_;
    43 };
    44
    45 void testSharedPtrObject() {
    46 std::shared_ptr<MyClass> objPtr1 = std::make_shared<MyClass>(100);
    47 std::cout << "objPtr1 的引用计数: " << objPtr1.use_count() << std::endl; // 输出 objPtr1 的引用计数: 1
    48 std::cout << "objPtr1 指向对象的值: " << objPtr1->getValue() << std::endl; // 输出 objPtr1 指向对象的值: 100
    49
    50 std::shared_ptr<MyClass> objPtr2 = objPtr1;
    51 std::cout << "objPtr1 的引用计数: " << objPtr1.use_count() << std::endl; // 输出 objPtr1 的引用计数: 2
    52 std::cout << "objPtr2 的引用计数: " << objPtr2.use_count() << std::endl; // 输出 objPtr2 的引用计数: 2
    53 } // objPtr1 和 objPtr2 超出作用域,引用计数降为 0,MyClass 对象被析构
    54
    55 int main() {
    56 testSharedPtr();
    57 testSharedPtrObject();
    58 return 0;
    59 }

    在上述示例中,shared_ptr 通过 std::make_shared 创建,并通过拷贝构造函数和赋值运算符实现共享所有权,引用计数随着 shared_ptr 对象的创建、销毁和赋值而增减。当所有指向同一对象的 shared_ptr 都被销毁时,被管理的对象才会被释放。reset() 方法可以显式地减少引用计数并可能释放对象。

    shared_ptr 适用于需要共享对象所有权的场景,例如在多线程程序中共享数据,或者在复杂对象关系图中管理对象的生命周期。然而,shared_ptr 的共享所有权机制也可能引入循环引用 (Circular Dependency) 的问题,导致内存泄漏,而 weak_ptr 正是为了解决这个问题而诞生的。

    1.2.3 weak_ptr (弱指针):非拥有性观察者 (Non-owning Observer)

    weak_ptr (弱指针) 是一种不控制对象生命周期的智能指针,它提供了对 shared_ptr 所管理对象的非拥有性 (Non-owning) 的访问。weak_ptr 不会增加对象的引用计数,因此,weak_ptr 的存在与否不会影响对象的释放时机。weak_ptr 的主要作用是观察 shared_ptr 所管理的对象,判断对象是否仍然存活,并在对象存活时安全地获取对象的访问权。weak_ptr 通常用于解决 shared_ptr 循环引用导致的内存泄漏问题,以及在某些需要“弱引用”的场景中。

    weak_ptr 的特点

    非拥有性:不参与对象的所有权管理,不会增加引用计数。
    观察者:可以观察 shared_ptr 所管理的对象是否存活。
    不直接访问对象:不能直接通过 weak_ptr 访问所指向的对象,必须先调用 lock() 方法尝试获取一个 shared_ptr
    解决循环引用:是打破 shared_ptr 循环引用的关键工具。

    weak_ptr 的使用示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 void testWeakPtr() {
    5 std::shared_ptr<int> sharedPtr = std::make_shared<int>(40);
    6 std::weak_ptr<int> weakPtr = sharedPtr; // weak_ptr 从 shared_ptr 构造
    7
    8 std::cout << "sharedPtr 的引用计数: " << sharedPtr.use_count() << std::endl; // 输出 sharedPtr 的引用计数: 1
    9 // weak_ptr 不影响引用计数
    10 std::cout << "weakPtr 是否过期 (expired): " << weakPtr.expired() << std::endl; // 输出 weakPtr 是否过期 (expired): 0 (未过期)
    11
    12 {
    13 std::shared_ptr<int> lockedPtr = weakPtr.lock(); // 尝试获取 shared_ptr
    14 if (lockedPtr) { // 检查是否成功获取
    15 std::cout << "成功从 weak_ptr 获取 shared_ptr" << std::endl;
    16 std::cout << "*lockedPtr: " << *lockedPtr << std::endl; // 输出 *lockedPtr: 40
    17 std::cout << "sharedPtr 的引用计数 (lock() 后): " << sharedPtr.use_count() << std::endl; // 输出 sharedPtr 的引用计数 (lock() 后): 2 (因为 lockedPtr 也指向同一对象)
    18 } else {
    19 std::cout << "weak_ptr 指向的对象已过期" << std::endl;
    20 }
    21 } // lockedPtr 超出作用域,析构,引用计数减少
    22
    23 std::cout << "sharedPtr 的引用计数 (lockedPtr 析构后): " << sharedPtr.use_count() << std::endl; // 输出 sharedPtr 的引用计数 (lockedPtr 析构后): 1
    24
    25 sharedPtr.reset(); // 释放 sharedPtr 的所有权,对象可能被销毁
    26 std::cout << "sharedPtr 被 reset() 后,引用计数: " << sharedPtr.use_count() << std::endl; // 输出 sharedPtr 被 reset() 后,引用计数: 0
    27 std::cout << "weakPtr 是否过期 (expired): " << weakPtr.expired() << std::endl; // 输出 weakPtr 是否过期 (expired): 1 (已过期)
    28
    29 std::shared_ptr<int> lockedPtr2 = weakPtr.lock(); // 再次尝试获取 shared_ptr
    30 if (lockedPtr2) {
    31 std::cout << "*lockedPtr2: " << *lockedPtr2 << std::endl;
    32 } else {
    33 std::cout << "weak_ptr 指向的对象已过期,无法获取 shared_ptr" << std::endl; // 输出 weak_ptr 指向的对象已过期,无法获取 shared_ptr
    34 }
    35 }
    36
    37 int main() {
    38 testWeakPtr();
    39 return 0;
    40 }

    在上述示例中,weak_ptr weakPtrshared_ptr sharedPtr 构造,但不增加引用计数。weakPtr.expired() 可以检查 weak_ptr 指向的对象是否已过期(即被销毁)。weakPtr.lock() 尝试获取一个指向同一对象的 shared_ptr。如果对象仍然存活,lock() 返回一个有效的 shared_ptr,否则返回一个空的 shared_ptr (nullptr)。

    weak_ptr 的核心价值在于解决 shared_ptr 循环引用问题,这是下一节要重点讨论的内容。

    1.3 为什么需要 weak_ptr (Why weak_ptr is Necessary)

    weak_ptr 的出现主要是为了解决 shared_ptr 在共享所有权时可能遇到的一个经典问题:循环引用 (Circular Dependency)。循环引用会导致内存泄漏,即使程序不再使用这些对象,它们所占用的内存也无法被释放。理解循环引用问题以及 weak_ptr 如何解决这个问题,是掌握 weak_ptr 价值的关键。

    1.3.1 循环引用问题 (Circular Dependency Problem)详解

    当两个或多个对象之间相互持有 shared_ptr,形成一个环状的引用关系时,就会发生循环引用。在这种情况下,即使从外部已经没有任何 shared_ptr 指向这个环上的任何对象,环内部的对象之间的引用计数永远不会降为零,从而导致这些对象永远无法被析构和释放,造成内存泄漏。

    循环引用的典型案例

    考虑一个父子节点关系 (Parent-Child Relationship) 的树形结构,其中每个节点都有一个指向其父节点的指针,以及一个或多个指向其子节点的指针。如果父节点使用 shared_ptr 指向子节点,同时子节点也使用 shared_ptr 指向父节点,就可能形成循环引用。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Node {
    6 public:
    7 std::string name;
    8 std::shared_ptr<Node> parent; // 使用 shared_ptr 指向父节点
    9 std::vector<std::shared_ptr<Node>> children; // 使用 shared_ptr 指向子节点
    10
    11 Node(const std::string& name) : name(name) {
    12 std::cout << "Node 构造函数被调用: " << name << std::endl;
    13 }
    14 ~Node() {
    15 std::cout << "Node 析构函数被调用: " << name << std::endl;
    16 }
    17 };
    18
    19 void testCircularReference() {
    20 std::shared_ptr<Node> nodeA = std::make_shared<Node>("NodeA");
    21 std::shared_ptr<Node> nodeB = std::make_shared<Node>("NodeB");
    22
    23 // 形成循环引用:A 指向 B,B 指向 A
    24 nodeA->children.push_back(nodeB);
    25 nodeB->parent = nodeA;
    26
    27 std::cout << "NodeA 的引用计数: " << nodeA.use_count() << std::endl; // 输出 NodeA 的引用计数: 2 (nodeA 和 nodeB->parent)
    28 std::cout << "NodeB 的引用计数: " << nodeB.use_count() << std::endl; // 输出 NodeB 的引用计数: 2 (nodeB 和 nodeA->children[0])
    29 } // nodeA 和 nodeB 超出作用域,析构
    30
    31 int main() {
    32 testCircularReference();
    33 std::cout << "testCircularReference 函数结束" << std::endl;
    34 return 0;
    35 }

    testCircularReference() 函数中,nodeAnodeB 之间形成了循环引用:nodeA 的子节点列表中包含了 nodeB,而 nodeB 的父节点指针指向了 nodeA。当 testCircularReference() 函数结束时,nodeAnodeB 这两个 shared_ptr 对象超出作用域被析构,它们的引用计数分别减 1,但由于循环引用的存在,nodeAnodeB 内部互相持有对方的 shared_ptr,导致它们的引用计数永远不会降为 0。因此,NodeANodeB 对象永远不会被析构,造成了内存泄漏。

    循环引用问题的本质

    循环引用的本质是所有权环 (Ownership Cycle)。在循环引用中,对象 A 拥有对象 B 的所有权,同时对象 B 又拥有对象 A 的所有权(或间接拥有)。这种相互所有权导致了引用计数机制无法正常工作,因为环上的每个对象的引用计数都至少为 1,即使外部不再有任何引用。

    循环引用导致的后果

    循环引用最直接的后果是内存泄漏 (Memory Leak)。泄漏的内存会不断累积,最终耗尽系统资源。在长时间运行的程序中,循环引用导致的内存泄漏尤其危险。

    1.3.2 weak_ptr 在打破循环引用中的作用 (The Role of weak_ptr in Breaking Circular Dependencies)

    weak_ptr 的设计目的之一就是为了打破 shared_ptr 的循环引用。由于 weak_ptr 不参与引用计数,它不会增加对象的引用计数,因此,在循环引用环中使用 weak_ptr 可以打破环路,使得引用计数可以正确地降为零,从而避免内存泄漏。

    使用 weak_ptr 解决循环引用

    在上述父子节点关系的例子中,为了解决循环引用问题,可以将子节点指向父节点的指针从 shared_ptr 改为 weak_ptr。这样,子节点仍然可以观察到父节点,但不会增加父节点的引用计数。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Node {
    6 public:
    7 std::string name;
    8 std::weak_ptr<Node> parent; // 使用 weak_ptr 指向父节点,打破循环引用
    9 std::vector<std::shared_ptr<Node>> children; // 使用 shared_ptr 指向子节点
    10
    11 Node(const std::string& name) : name(name) {
    12 std::cout << "Node 构造函数被调用: " << name << std::endl;
    13 }
    14 ~Node() {
    15 std::cout << "Node 析构函数被调用: " << name << std::endl;
    16 }
    17
    18 std::shared_ptr<Node> getParent() const {
    19 return parent.lock(); // 使用 lock() 获取 shared_ptr 访问父节点
    20 }
    21 };
    22
    23 void testBreakCircularReference() {
    24 std::shared_ptr<Node> nodeA = std::make_shared<Node>("NodeA");
    25 std::shared_ptr<Node> nodeB = std::make_shared<Node>("NodeB");
    26
    27 // 使用 weak_ptr 打破循环引用:B 指向 A 使用 weak_ptr
    28 nodeA->children.push_back(nodeB);
    29 nodeB->parent = nodeA; // nodeB 的 parent 是 weak_ptr<Node>
    30
    31 std::cout << "NodeA 的引用计数: " << nodeA.use_count() << std::endl; // 输出 NodeA 的引用计数: 1 (只有 nodeA 本身)
    32 std::cout << "NodeB 的引用计数: " << nodeB.use_count() << std::endl; // 输出 NodeB 的引用计数: 1 (只有 nodeB 本身和 nodeA->children[0])
    33
    34 // 访问父节点需要使用 lock()
    35 std::shared_ptr<Node> parentOfB = nodeB->getParent();
    36 if (parentOfB) {
    37 std::cout << "NodeB 的父节点是: " << parentOfB->name << std::endl; // 输出 NodeB 的父节点是: NodeA
    38 } else {
    39 std::cout << "NodeB 的父节点已过期" << std::endl;
    40 }
    41 } // nodeA 和 nodeB 超出作用域,析构
    42
    43 int main() {
    44 testBreakCircularReference();
    45 std::cout << "testBreakCircularReference 函数结束" << std::endl;
    46 return 0;
    47 }

    在这个修改后的 testBreakCircularReference() 函数中,Node 类的 parent 成员变量类型从 std::shared_ptr<Node> 更改为 std::weak_ptr<Node>。这样,nodeB->parent = nodeA; 这行代码不会增加 nodeA 的引用计数。当 testBreakCircularReference() 函数结束时,nodeAnodeB 的引用计数都会降为 0,NodeANodeB 对象会被正确析构,从而避免了内存泄漏。

    weak_ptr 打破循环引用的原理

    通过将循环引用环中的至少一个 shared_ptr 替换为 weak_ptr,就打破了所有权环。weak_ptr 提供了对对象的观察能力,但不承担所有权,因此不会影响引用计数。当外部的 shared_ptr 不再指向环上的对象时,环上的对象的引用计数最终会降为 0,从而使得整个对象环可以被安全地释放。

    weak_ptr 的使用限制

    由于 weak_ptr 不控制对象的生命周期,因此不能直接通过 weak_ptr 访问对象。要访问 weak_ptr 指向的对象,必须先调用 lock() 方法尝试获取一个 shared_ptrlock() 方法会检查 weak_ptr 指向的对象是否仍然存活。如果对象存活,lock() 返回一个有效的 shared_ptr,使得可以安全地访问对象;如果对象已经销毁,lock() 返回一个空的 shared_ptr (nullptr)。这种机制保证了在使用 weak_ptr 访问对象时的安全性。

    总结

    weak_ptr 是解决 shared_ptr 循环引用问题的关键工具。通过在对象关系中使用 weak_ptr 来打破所有权环,可以避免内存泄漏,并实现更健壮的内存管理。在设计复杂对象关系,特别是可能出现循环引用的场景时,合理使用 weak_ptr 是至关重要的。

    2. weak_ptr 的原理与机制 (Principles and Mechanisms of weak_ptr)

    本章深入解析 weak_ptr (弱指针) 的内部工作原理,包括其结构、状态以及关键操作,帮助读者从底层理解 weak_ptr 的行为。

    2.1 weak_ptr 的内部结构 (Internal Structure of weak_ptr)

    weak_ptr (弱指针) 是一种不控制所指向对象生命周期的智能指针。它被设计为 shared_ptr (共享指针) 的辅助工具,用于观察 shared_ptr 管理的对象,而不会增加对象的引用计数。理解 weak_ptr 的内部结构,有助于我们更好地掌握其工作原理和应用场景。

    在深入 weak_ptr 的内部结构之前,回顾一下 shared_ptr (共享指针) 的控制块 (Control Block) 是非常重要的。shared_ptr 使用控制块来管理以下信息:

    引用计数 (Reference Count):记录有多少个 shared_ptr 指向同一个对象。当引用计数降为零时,对象会被销毁。
    弱引用计数 (Weak Count):记录有多少个 weak_ptr 指向同一个对象。当弱引用计数降为零,且引用计数也为零时,控制块自身也会被销毁。
    删除器 (Deleter) (可选):当引用计数降为零时,用于释放对象资源的函数对象。
    分配器 (Allocator) (可选):用于分配和释放控制块的分配器。

    weak_ptr 并不直接拥有对象,而是观察shared_ptr 管理的对象。这意味着 weak_ptr 必须能够访问到 shared_ptr 的控制块,以便了解所观察对象的状态(例如,是否仍然存活)。

    weak_ptr 的内部结构主要包含以下部分:

    ① 指向控制块 (Control Block) 的指针:这是 weak_ptr 内部最核心的部分。这个指针与创建它的 shared_ptr 指向相同的控制块。通过这个控制块,weak_ptr 可以访问到对象的弱引用计数,并判断对象是否仍然存活。注意,weak_ptr 并不直接存储指向实际对象的指针。实际对象的生命周期由 shared_ptr 的引用计数管理。

    默认构造函数 (Default Constructor)weak_ptr 可以被默认构造,此时它不指向任何对象,即为空 (null)。

    shared_ptr 或另一个 weak_ptr 构造的构造函数 (Constructor from shared_ptr or another weak_ptr): 当从一个 shared_ptr 或另一个指向相同控制块的 weak_ptr 构造 weak_ptr 时,新的 weak_ptr 将指向相同的控制块,并且弱引用计数 (Weak Count) 会增加。

    可以用一个简化的示意图来表示 weak_ptrshared_ptr 之间的关系:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 +--------------+ +-----------------------+ +---------+
    2 | shared_ptr |----->| Control Block |----->| Object |
    3 +--------------+ +-----------------------+ +---------+
    4 ^ | - Reference Count |
    5 | | - Weak Count |
    6 | | - Deleter (optional) |
    7 | | - Allocator (optional)|
    8 | +-----------------------+
    9 | ^
    10 | |
    11 +--------------+ |
    12 | weak_ptr |-----------+
    13 +--------------+

    关键点总结

    weak_ptr 内部主要持有一个指向 shared_ptr 控制块的指针。
    weak_ptr 不直接持有指向实际对象的指针。
    weak_ptr 的创建(从 shared_ptr 或另一个 weak_ptr)会增加控制块中的弱引用计数 (Weak Count),但不增加引用计数 (Reference Count)
    weak_ptr 的析构会减少控制块中的弱引用计数 (Weak Count)
    weak_ptr 依赖于 shared_ptr 的控制块来追踪对象的状态,但自身不参与对象生命周期的管理。

    理解了 weak_ptr 的内部结构,我们就能更好地理解其状态和操作,这将在接下来的章节中详细介绍。

    2.2 weak_ptr 的状态:有效与过期 (States of weak_ptr: Valid and Expired)

    weak_ptr (弱指针) 有两种主要状态:有效 (Valid)过期 (Expired)。这两种状态反映了 weak_ptr 所观察对象的生命周期状态。

    有效 (Valid)

    ⚝ 当 weak_ptr 处于有效状态时,意味着它所观察的对象仍然存活。更准确地说,是指与 weak_ptr 关联的 shared_ptr (共享指针) 所管理的对象仍然存在,即对象的引用计数 (Reference Count) 大于零。
    ⚝ 处于有效状态的 weak_ptr 可以通过 lock() 操作尝试获取一个指向该对象的 shared_ptr。如果 lock() 成功,它会返回一个新的 shared_ptr,并将对象的引用计数增加,从而确保在返回的 shared_ptr 生命周期内,对象保持存活。

    过期 (Expired)

    ⚝ 当 weak_ptr 处于过期状态时,意味着它所观察的对象已经被销毁。更准确地说,是指与 weak_ptr 关联的 shared_ptr 所管理的对象已经不再存在,即对象的引用计数 (Reference Count) 已经降为零。
    ⚝ 一旦对象被销毁,即使 weak_ptr 本身仍然存在,它也无法再访问到有效的对象。此时,如果尝试通过过期的 weak_ptr 调用 lock() 操作,lock() 将会返回一个shared_ptr (nullptr)

    如何判断 weak_ptr 的状态

    weak_ptr 提供了 expired() 方法来显式地检查其状态。

    expired() 方法:返回一个 bool 值。
    ▮▮▮▮⚝ 如果 weak_ptr 过期expired() 返回 true
    ▮▮▮▮⚝ 如果 weak_ptr 有效expired() 返回 false

    状态转换

    weak_ptr 的状态转换是自动发生的,由 shared_ptr 的引用计数管理驱动。
    ⚝ 当最后一个指向对象的 shared_ptr 被销毁,对象的引用计数降为零时,对象被销毁。此时,所有指向该对象的 weak_ptr 都会自动变为过期 (Expired) 状态。
    ⚝ 在此之前,只要至少有一个 shared_ptr 指向对象,所有相关的 weak_ptr 都保持有效 (Valid) 状态。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 int main() {
    5 auto sharedPtr = std::make_shared<int>(42); // 创建 shared_ptr,引用计数为 1
    6 std::weak_ptr<int> weakPtr = sharedPtr; // 从 shared_ptr 创建 weak_ptr,弱引用计数增加
    7
    8 std::cout << "weakPtr expired? " << weakPtr.expired() << std::endl; // 输出:weakPtr expired? 0 (false) - 有效
    9
    10 sharedPtr.reset(); // 销毁 sharedPtr,引用计数降为 0,对象被销毁
    11
    12 std::cout << "weakPtr expired? " << weakPtr.expired() << std::endl; // 输出:weakPtr expired? 1 (true) - 过期
    13
    14 auto lockedPtr = weakPtr.lock(); // 尝试通过 lock() 获取 shared_ptr
    15
    16 if (lockedPtr) {
    17 std::cout << "Successfully locked weak_ptr, value: " << *lockedPtr << std::endl;
    18 } else {
    19 std::cout << "Failed to lock weak_ptr, weak_ptr is expired." << std::endl; // 输出:Failed to lock weak_ptr, weak_ptr is expired.
    20 }
    21
    22 return 0;
    23 }

    总结

    weak_ptr 的状态反映了其观察对象是否仍然存活。
    有效 (Valid) 状态表示对象仍然存活,可以通过 lock() 获取 shared_ptr
    过期 (Expired) 状态表示对象已被销毁,lock() 会返回空指针 (nullptr)。
    ⚝ 使用 expired() 方法可以显式检查 weak_ptr 的状态。
    weak_ptr 的状态转换由 shared_ptr 的引用计数管理自动控制。

    理解 weak_ptr 的有效和过期状态是正确使用 weak_ptr 的关键,尤其是在需要处理对象生命周期和避免悬挂指针 (Dangling Pointer) 的场景中。

    2.3 weak_ptr 的关键操作:lock() (Key Operations of weak_ptr: lock())

    lock()weak_ptr (弱指针) 最关键的操作,也是使用 weak_ptr 的核心步骤。lock() 操作的目的是尝试从 weak_ptr 获取一个有效的 shared_ptr (共享指针),从而安全地访问所观察的对象。

    lock() 操作的工作机制

    检查 weak_ptr 的状态lock() 首先会检查 weak_ptr 是否过期 (Expired)。可以通过检查控制块中的引用计数 (Reference Count) 是否为零来判断。如果引用计数为零,则对象已被销毁,weak_ptr 处于过期状态。

    如果 weak_ptr 有效 (Valid)
    ▮▮▮▮⚝ lock()增加控制块中的引用计数 (Reference Count)
    ▮▮▮▮⚝ 返回一个新的 shared_ptr,这个 shared_ptr 指向 weak_ptr 所观察的同一个对象
    ▮▮▮▮⚝ 因为引用计数增加,所以对象会保持存活,至少在返回的 shared_ptr 的生命周期内是如此。

    如果 weak_ptr 过期 (Expired)
    ▮▮▮▮⚝ lock() 不会增加引用计数
    ▮▮▮▮⚝ 返回一个 空的 shared_ptr (nullptr)

    lock() 操作的返回值

    lock() 返回的是一个 std::shared_ptr<T> 对象,其中 Tweak_ptr 所指向的对象类型。
    ⚝ 如果 lock() 成功获取到 shared_ptr(即 weak_ptr 有效),则返回的 shared_ptr 非空,可以像普通的 shared_ptr 一样使用,例如解引用访问对象。
    ⚝ 如果 lock() 失败(即 weak_ptr 过期),则返回的 shared_ptr 为空 (nullptr)

    使用 lock() 的典型模式

    在使用 weak_ptr 访问对象时,通常需要遵循以下模式:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 std::weak_ptr<MyObject> weakObjPtr; // 假设 weakObjPtr 已经初始化
    2
    3 // ... 一些操作 ...
    4
    5 std::shared_ptr<MyObject> sharedObjPtr = weakObjPtr.lock(); // 尝试 lock()
    6
    7 if (sharedObjPtr) { // 检查 lock() 是否成功,即 sharedObjPtr 是否非空
    8 // lock() 成功,sharedObjPtr 是一个有效的 shared_ptr,可以安全地使用
    9 sharedObjPtr->doSomething(); // 安全访问对象
    10
    11 // 在 sharedObjPtr 的生命周期结束时(例如,超出作用域),
    12 // 引用计数会自动减少,但对象仍然可能存活,
    13 // 只要还有其他 shared_ptr 指向它。
    14 } else {
    15 // lock() 失败,weak_ptr 已经过期,对象已被销毁
    16 // 不能访问对象,需要进行相应的错误处理或逻辑处理
    17 std::cout << "Object is no longer available." << std::endl;
    18 }

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 class MyClass {
    5 public:
    6 void printMessage() const {
    7 std::cout << "Hello from MyClass!" << std::endl;
    8 }
    9 };
    10
    11 int main() {
    12 auto sharedPtr = std::make_shared<MyClass>(); // 创建 shared_ptr
    13 std::weak_ptr<MyClass> weakPtr = sharedPtr; // 从 shared_ptr 创建 weak_ptr
    14
    15 { // 引入一个作用域,用于控制 lockedPtr 的生命周期
    16 std::shared_ptr<MyClass> lockedPtr = weakPtr.lock(); // lock() 操作
    17 if (lockedPtr) {
    18 std::cout << "Lock successful!" << std::endl;
    19 lockedPtr->printMessage(); // 安全访问对象
    20 } else {
    21 std::cout << "Lock failed, weak_ptr is expired." << std::endl;
    22 }
    23 // lockedPtr 在这里超出作用域,sharedPtr 的引用计数减少 (但对象可能仍然存活)
    24 }
    25
    26 sharedPtr.reset(); // 销毁 sharedPtr,对象被销毁
    27
    28 std::shared_ptr<MyClass> lockedPtr2 = weakPtr.lock(); // 再次 lock() 操作
    29 if (lockedPtr2) {
    30 std::cout << "Lock successful (this should not happen)!" << std::endl;
    31 lockedPtr2->printMessage();
    32 } else {
    33 std::cout << "Lock failed, weak_ptr is expired (as expected)." << std::endl; // 输出:Lock failed, weak_ptr is expired (as expected).
    34 }
    35
    36 return 0;
    37 }

    总结

    lock()weak_ptr 的核心操作,用于尝试获取有效的 shared_ptr
    lock()weak_ptr 有效时返回一个非空的 shared_ptr,并增加引用计数。
    lock()weak_ptr 过期时返回一个空的 shared_ptr (nullptr)。
    ⚝ 必须检查 lock() 的返回值是否为空,以确保安全地访问对象。
    lock() 操作是使用 weak_ptr 的标准模式,用于在不延长对象生命周期的情况下安全地访问可能已经销毁的对象。

    2.4 weak_ptr 的其他操作:expired()、reset()、use_count() (Other Operations of weak_ptr: expired(), reset(), use_count())

    除了关键的 lock() 操作之外,weak_ptr (弱指针) 还提供了一些其他的辅助操作,用于更灵活地管理和查询 weak_ptr 的状态和信息。这些操作包括 expired()reset()use_count()

    expired() 操作

    功能expired() 方法用于显式检查 weak_ptr 是否过期 (Expired)
    返回值:返回一个 bool 值。
    ▮▮▮▮⚝ true:表示 weak_ptr 过期,即所观察的对象已被销毁。
    ▮▮▮▮⚝ false:表示 weak_ptr 有效,即所观察的对象仍然存活。
    用法expired() 方法通常用于在尝试 lock() 之前,或者在不需要获取 shared_ptr,仅仅需要知道对象是否还存活的情况下使用。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 int main() {
    5 auto sharedPtr = std::make_shared<int>(100);
    6 std::weak_ptr<int> weakPtr = sharedPtr;
    7
    8 if (!weakPtr.expired()) { // 使用 expired() 检查是否过期
    9 std::cout << "weakPtr is valid." << std::endl;
    10 } else {
    11 std::cout << "weakPtr is expired." << std::endl;
    12 }
    13
    14 sharedPtr.reset(); // 销毁 sharedPtr
    15
    16 if (weakPtr.expired()) { // 再次使用 expired() 检查
    17 std::cout << "weakPtr is now expired." << std::endl; // 输出:weakPtr is now expired.
    18 } else {
    19 std::cout << "weakPtr is still valid (this should not happen)." << std::endl;
    20 }
    21
    22 return 0;
    23 }

    reset() 操作

    功能reset() 方法用于重置 weak_ptr,使其不再观察任何对象。
    效果
    ▮▮▮▮⚝ 如果 weak_ptr 原本指向一个对象,调用 reset()减少控制块中的弱引用计数 (Weak Count)
    ▮▮▮▮⚝ 调用 reset() 后,weak_ptr 变为空 (null),就像默认构造的 weak_ptr 一样。
    ▮▮▮▮⚝ 之后,对这个 weak_ptr 调用 expired() 将会返回 true,调用 lock() 将会返回空指针 (nullptr)。
    用法reset() 方法通常在需要显式地断开 weak_ptr 与对象的关联时使用,例如在对象生命周期管理或者资源清理的场景中。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 int main() {
    5 auto sharedPtr = std::make_shared<double>(3.14);
    6 std::weak_ptr<double> weakPtr = sharedPtr;
    7
    8 std::cout << "weakPtr expired before reset? " << weakPtr.expired() << std::endl; // 输出:weakPtr expired before reset? 0
    9
    10 weakPtr.reset(); // 调用 reset()
    11
    12 std::cout << "weakPtr expired after reset? " << weakPtr.expired() << std::endl; // 输出:weakPtr expired after reset? 1
    13
    14 auto lockedPtr = weakPtr.lock();
    15 if (lockedPtr) {
    16 std::cout << "Lock successful (this should not happen)." << std::endl;
    17 } else {
    18 std::cout << "Lock failed after reset, as expected." << std::endl; // 输出:Lock failed after reset, as expected.
    19 }
    20
    21 return 0;
    22 }

    use_count() 操作

    功能use_count() 方法用于获取与 weak_ptr 关联的 shared_ptr 的引用计数 (Reference Count)
    返回值:返回一个 long 类型的值,表示当前有多少个 shared_ptr 指向同一个对象。
    重要注意weak_ptr 本身不影响引用计数use_count() 返回的是 shared_ptr 的引用计数,而不是弱引用计数。不要混淆引用计数和弱引用计数
    用法use_count() 方法主要用于调试或监控目的,可以帮助了解对象的共享状态。在实际编程中,通常不依赖 use_count() 的返回值来决定程序逻辑,因为它可能存在竞争条件,导致返回的值不总是完全准确

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 int main() {
    5 auto sharedPtr1 = std::make_shared<char>('A');
    6 std::cout << "sharedPtr1 use_count: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count: 1
    7
    8 std::shared_ptr<char> sharedPtr2 = sharedPtr1; // 拷贝 sharedPtr,引用计数增加
    9 std::cout << "sharedPtr1 use_count after copy: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count after copy: 2
    10
    11 std::weak_ptr<char> weakPtr = sharedPtr1; // 从 sharedPtr 创建 weak_ptr
    12 std::cout << "sharedPtr1 use_count after weak_ptr: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count after weak_ptr: 2 (引用计数不变)
    13 std::cout << "weakPtr use_count: " << weakPtr.use_count() << std::endl; // 输出:weakPtr use_count: 2 (weak_ptr 可以访问到引用计数)
    14
    15 weakPtr.reset(); // reset weak_ptr,不影响引用计数
    16 std::cout << "sharedPtr1 use_count after weak_ptr reset: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count after weak_ptr reset: 2
    17 std::cout << "weakPtr use_count after weak_ptr reset: " << weakPtr.use_count() << std::endl; // 输出:weakPtr use_count after weak_ptr reset: 2 (weak_ptr reset 不影响 use_count)
    18
    19 sharedPtr1.reset(); // reset sharedPtr1,引用计数减少
    20 std::cout << "sharedPtr1 use_count after sharedPtr1 reset: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count after sharedPtr1 reset: 1
    21 std::cout << "weakPtr use_count after sharedPtr1 reset: " << weakPtr.use_count() << std::endl; // 输出:weakPtr use_count after sharedPtr1 reset: 1
    22
    23 sharedPtr2.reset(); // reset sharedPtr2,引用计数再次减少,最终为 0,对象销毁
    24 std::cout << "sharedPtr1 use_count after sharedPtr2 reset: " << sharedPtr1.use_count() << std::endl; // 输出:sharedPtr1 use_count after sharedPtr2 reset: 0
    25 std::cout << "weakPtr use_count after sharedPtr2 reset: " << weakPtr.use_count() << std::endl; // 输出:weakPtr use_count after sharedPtr2 reset: 0
    26
    27 return 0;
    28 }

    总结

    expired():检查 weak_ptr 是否过期。
    reset():重置 weak_ptr,使其不再观察任何对象,并减少弱引用计数。
    use_count():获取关联的 shared_ptr 的引用计数(注意:weak_ptr 本身不影响引用计数)。
    ⚝ 这些操作为 weak_ptr 提供了更全面的功能,使其在复杂的资源管理场景中更加灵活和实用。理解这些操作有助于更好地掌握 weak_ptr 的使用方法,并写出更健壮的 C++ 代码。

    3. weak_ptr 的应用场景 (Application Scenarios of weak_ptr)

    3.1 解决循环引用 (Resolving Circular Dependencies)的经典案例

    3.1.1 父子节点关系 (Parent-Child Relationship)的树形结构

    概述

    在树形结构中,父节点通常拥有子节点,而子节点有时也需要反向引用父节点。如果父节点和子节点之间都使用 shared_ptr (共享指针) 来互相引用,就会形成循环引用,导致内存泄漏 (Memory Leak)。使用 weak_ptr (弱指针) 可以有效地打破这种循环引用,在子节点需要访问父节点时,使用 weak_ptr 观察父节点,而不会增加父节点的引用计数,从而避免循环引用的产生。

    详细解析

    考虑一个典型的树形结构,其中 Node (节点) 类可以有多个子节点,并且每个子节点需要知道其父节点。如果使用 shared_ptr 来表示父子关系,就会出现问题。

    假设 Node 类定义如下,使用 shared_ptr<Node> 来表示父节点和子节点:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Node {
    6 public:
    7 std::string name;
    8 std::shared_ptr<Node> parent; // 指向父节点的共享指针
    9 std::vector<std::shared_ptr<Node>> children; // 指向子节点的共享指针向量
    10
    11 Node(std::string n) : name(n) {
    12 std::cout << "Node " << name << " created" << std::endl;
    13 }
    14 ~Node() {
    15 std::cout << "Node " << name << " destroyed" << std::endl;
    16 }
    17
    18 void addChild(std::shared_ptr<Node> child) {
    19 children.push_back(child);
    20 child->parent = std::shared_from_this(); // 子节点反向指向父节点
    21 }
    22 };
    23
    24 int main() {
    25 auto nodeA = std::make_shared<Node>("A");
    26 auto nodeB = std::make_shared<Node>("B");
    27 auto nodeC = std::make_shared<Node>("C");
    28
    29 nodeA->addChild(nodeB); // A 指向 B
    30 nodeB->addChild(nodeC); // B 指向 C
    31
    32 // 此时 A 指向 B, B 指向 C, B 也指向 A (通过 child->parent), C 也指向 B (通过 child->parent)
    33 // 形成 A <-> B <-> C 这样的关系,但实际上是树形结构,应该只有父指向子
    34
    35 return 0;
    36 }

    在这个例子中,nodeAnodeBnodeC 都是 shared_ptr,并且它们之间通过 parentchildren 互相引用。当 main 函数结束时,nodeAnodeBnodeC 超出作用域,但由于循环引用,它们的引用计数永远不会降为零,导致内存泄漏。具体来说:

    nodeA 指向的 Node A 对象,被 nodeA 智能指针和一个来自 nodeB->parent 的智能指针引用,引用计数为 2。
    nodeB 指向的 Node B 对象,被 nodeB 智能指针,来自 nodeA->children 的智能指针,以及来自 nodeC->parent 的智能指针引用,引用计数至少为 3。
    nodeC 指向的 Node C 对象,被 nodeC 智能指针和来自 nodeB->children 的智能指针引用,引用计数为 2。

    main 函数结束时,nodeA, nodeB, nodeC 析构,引用计数分别减 1,但由于循环引用,它们的引用计数仍然大于 0,导致 Node A, Node B, Node C 对象无法被销毁,造成内存泄漏。

    为了解决这个问题,可以将子节点指向父节点的指针改为 weak_ptr。修改 Node 类的定义如下:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Node {
    6 public:
    7 std::string name;
    8 std::weak_ptr<Node> parent; // 指向父节点的弱指针
    9 std::vector<std::shared_ptr<Node>> children; // 指向子节点的共享指针向量
    10
    11 Node(std::string n) : name(n) {
    12 std::cout << "Node " << name << " created" << std::endl;
    13 }
    14 ~Node() {
    15 std::cout << "Node " << name << " destroyed" << std::endl;
    16 }
    17
    18 void addChild(std::shared_ptr<Node> child) {
    19 children.push_back(child);
    20 child->parent = std::shared_from_this(); // 子节点反向指向父节点 (weak_ptr 不影响引用计数)
    21 }
    22
    23 std::shared_ptr<Node> getParent() {
    24 return parent.lock(); // 使用 lock() 获取 shared_ptr 访问父节点
    25 }
    26 };
    27
    28 int main() {
    29 auto nodeA = std::make_shared<Node>("A");
    30 auto nodeB = std::make_shared<Node>("B");
    31 auto nodeC = std::make_shared<Node>("C");
    32
    33 nodeA->addChild(nodeB);
    34 nodeB->addChild(nodeC);
    35
    36 // 此时 nodeB->parent 和 nodeC->parent 是 weak_ptr,不增加引用计数
    37 // 只有 nodeA, nodeB, nodeC 和 children 保持 shared_ptr 引用
    38
    39 return 0;
    40 }

    修改后的代码中,Node 类中 parent 成员变量的类型从 std::shared_ptr<Node> 变为了 std::weak_ptr<Node>。这样,子节点指向父节点时,使用的是 weak_ptr,不会增加父节点的引用计数。当 main 函数结束时,nodeAnodeBnodeC 超出作用域,它们的引用计数会降为零,从而正确地析构 Node ANode BNode C 对象,避免了内存泄漏。

    当子节点需要访问父节点时,需要使用 weak_ptrlock() 方法。lock() 方法尝试将 weak_ptr 提升为 shared_ptr。如果 weak_ptr 指向的对象仍然存活(即引用计数大于 0),lock() 方法会返回一个有效的 shared_ptr;如果对象已经被销毁(即引用计数降为 0),lock() 方法会返回一个空的 shared_ptr (nullptr)。

    Node 类中,添加了 getParent() 方法,用于安全地获取父节点的 shared_ptr

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 std::shared_ptr<Node> getParent() {
    2 return parent.lock(); // 使用 lock() 尝试获取 shared_ptr
    3 }

    main 函数结束时,由于 parent 指针是 weak_ptr,不参与引用计数,因此循环引用被打破,内存得到正确释放,程序的输出会显示所有 Node 对象的析构函数被调用。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Node {
    6 public:
    7 std::string name;
    8 std::weak_ptr<Node> parent;
    9 std::vector<std::shared_ptr<Node>> children;
    10
    11 Node(std::string n) : name(n) {
    12 std::cout << "Node " << name << " created" << std::endl;
    13 }
    14 ~Node() {
    15 std::cout << "Node " << name << " destroyed" << std::endl;
    16 }
    17
    18 void addChild(std::shared_ptr<Node> child) {
    19 children.push_back(child);
    20 child->parent = std::shared_from_this();
    21 }
    22
    23 std::shared_ptr<Node> getParent() {
    24 return parent.lock();
    25 }
    26
    27 void printParentName() {
    28 std::shared_ptr<Node> p = getParent();
    29 if (p) {
    30 std::cout << name << "'s parent is " << p->name << std::endl;
    31 } else {
    32 std::cout << name << "'s parent is null (expired)" << std::endl;
    33 }
    34 }
    35 };
    36
    37 int main() {
    38 { // 使用代码块限制 nodeA 的生命周期
    39 auto nodeA = std::make_shared<Node>("A");
    40 auto nodeB = std::make_shared<Node>("B");
    41 auto nodeC = std::make_shared<Node>("C");
    42
    43 nodeA->addChild(nodeB);
    44 nodeB->addChild(nodeC);
    45
    46 nodeB->printParentName(); // B's parent is A
    47 nodeC->printParentName(); // C's parent is B
    48 } // nodeA, nodeB, nodeC 超出作用域,由于 weak_ptr 打破循环引用,对象会被正确析构
    49
    50 std::cout << "程序结束" << std::endl;
    51 return 0;
    52 }

    运行上述代码,可以看到 Node ANode BNode C 的创建和销毁信息,证明使用 weak_ptr 成功解决了树形结构中的循环引用问题。输出结果会显示所有节点的创建和析构信息,以及 BC 成功访问并打印了其父节点的名字。当代码块结束时,由于没有循环引用,所有智能指针的引用计数最终降为 0,对象被正确析构,避免了内存泄漏。

    3.1.2 双向关联的对象 (Bidirectional Associated Objects)

    概述

    在设计类时,有时需要两个对象互相引用对方,形成双向关联。例如,Document (文档) 和 Page (页面) 类,一个文档包含多个页面,而每个页面也需要知道它属于哪个文档。如果 DocumentPage 类都使用 shared_ptr 互相引用,同样会造成循环引用。此时,可以使用 weak_ptr 来管理其中一个方向的引用,打破循环依赖。

    详细解析

    考虑 DocumentPage 类的例子。一个 Document 对象可以包含多个 Page 对象,而每个 Page 对象需要知道它属于哪个 Document

    如果使用 shared_ptr 实现双向关联,Document 持有 Pageshared_ptr 列表,Page 也持有一个指向 Documentshared_ptr,就会形成循环引用。

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4
    5 class Document; // 前向声明
    6
    7 class Page {
    8 public:
    9 std::string content;
    10 std::shared_ptr<Document> document; // 指向所属文档的共享指针
    11
    12 Page(std::string c) : content(c) {
    13 std::cout << "Page created: " << content << std::endl;
    14 }
    15 ~Page() {
    16 std::cout << "Page destroyed: " << content << std::endl;
    17 }
    18 };
    19
    20 class Document {
    21 public:
    22 std::string title;
    23 std::vector<std::shared_ptr<Page>> pages; // 包含页面的共享指针列表
    24
    25 Document(std::string t) : title(t) {
    26 std::cout << "Document created: " << title << std::endl;
    27 }
    28 ~Document() {
    29 std::cout << "Document destroyed: " << title << std::endl;
    30 }
    31
    32 void addPage(std::shared_ptr<Page> page) {
    33 pages.push_back(page);
    34 page->document = std::shared_from_this(); // 页面反向指向文档
    35 }
    36 };
    37
    38 int main() {
    39 auto doc = std::make_shared<Document>("My Document");
    40 auto page1 = std::make_shared<Page>("Page 1 Content");
    41 auto page2 = std::make_shared<Page>("Page 2 Content");
    42
    43 doc->addPage(page1);
    44 doc->addPage(page2);
    45
    46 // doc 指向 page1, page2, page1 和 page2 也指向 doc, 形成循环引用
    47
    48 return 0;
    49 }

    在这个例子中,Document 对象 doc 持有 page1page2shared_ptr,而 page1page2 也持有指向 docshared_ptr,形成了循环引用。当 main 函数结束时,docpage1page2 超出作用域,但由于循环引用,它们的引用计数无法降为零,导致内存泄漏。

    为了解决这个问题,可以将 Page 类中指向 Document 的指针改为 weak_ptr。修改 Page 类的定义如下:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <string>
    5 #include <memory>
    6
    7 class Document; // 前向声明
    8
    9 class Page {
    10 public:
    11 std::string content;
    12 std::weak_ptr<Document> document; // 指向所属文档的弱指针
    13
    14 Page(std::string c) : content(c) {
    15 std::cout << "Page created: " << content << std::endl;
    16 }
    17 ~Page() {
    18 std::cout << "Page destroyed: " << content << std::endl;
    19 }
    20
    21 std::shared_ptr<Document> getDocument() {
    22 return document.lock(); // 使用 lock() 获取 shared_ptr 访问文档
    23 }
    24 };
    25
    26 class Document {
    27 public:
    28 std::string title;
    29 std::vector<std::shared_ptr<Page>> pages; // 包含页面的共享指针列表
    30
    31 Document(std::string t) : title(t) {
    32 std::cout << "Document created: " << title << std::endl;
    33 }
    34 ~Document() {
    35 std::cout << "Document destroyed: " << title << std::endl;
    36 }
    37
    38 void addPage(std::shared_ptr<Page> page) {
    39 pages.push_back(page);
    40 page->document = std::shared_from_this(); // 页面反向指向文档 (weak_ptr 不影响引用计数)
    41 }
    42
    43 void printPagesDocumentTitle() {
    44 for (const auto& pagePtr : pages) {
    45 std::shared_ptr<Document> docPtr = pagePtr->getDocument();
    46 if (docPtr) {
    47 std::cout << "Page '" << pagePtr->content << "' belongs to document: " << docPtr->title << std::endl;
    48 } else {
    49 std::cout << "Page '" << pagePtr->content << "' document is null (expired)" << std::endl;
    50 }
    51 }
    52 }
    53 };
    54
    55 int main() {
    56 { // 使用代码块限制 doc 的生命周期
    57 auto doc = std::make_shared<Document>("My Document");
    58 auto page1 = std::make_shared<Page>("Page 1 Content");
    59 auto page2 = std::make_shared<Page>("Page 2 Content");
    60
    61 doc->addPage(page1);
    62 doc->addPage(page2);
    63
    64 doc->printPagesDocumentTitle(); // 打印页面的文档标题
    65 } // doc, page1, page2 超出作用域,由于 weak_ptr 打破循环引用,对象会被正确析构
    66
    67 std::cout << "程序结束" << std::endl;
    68 return 0;
    69 }

    修改后的代码中,Page 类中 document 成员变量的类型从 std::shared_ptr<Document> 变为了 std::weak_ptr<Document>。这样,页面指向文档时,使用的是 weak_ptr,不会增加文档的引用计数。循环引用被打破,当 main 函数结束时,docpage1page2 超出作用域,它们的引用计数最终降为零,对象被正确析构,避免了内存泄漏。

    Page 类中添加了 getDocument() 方法,使用 weak_ptrlock() 方法尝试获取 Document 对象的 shared_ptr,以安全地访问所属的文档。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <string>
    5 #include <memory>
    6
    7 class Document; // 前向声明
    8
    9 class Page {
    10 public:
    11 std::string content;
    12 std::weak_ptr<Document> document; // 指向所属文档的弱指针
    13
    14 Page(std::string c) : content(c) {
    15 std::cout << "Page created: " << content << std::endl;
    16 }
    17 ~Page() {
    18 std::cout << "Page destroyed: " << content << std::endl;
    19 }
    20
    21 std::shared_ptr<Document> getDocument() {
    22 return document.lock(); // 使用 lock() 获取 shared_ptr 访问文档
    23 }
    24
    25 void printDocumentTitle() {
    26 std::shared_ptr<Document> docPtr = getDocument();
    27 if (docPtr) {
    28 std::cout << "Page '" << content << "' belongs to document: " << docPtr->title << std::endl;
    29 } else {
    30 std::cout << "Page '" << content << "' document is null (expired)" << std::endl;
    31 }
    32 }
    33 };
    34
    35 class Document {
    36 public:
    37 std::string title;
    38 std::vector<std::shared_ptr<Page>> pages; // 包含页面的共享指针列表
    39
    40 Document(std::string t) : title(t) {
    41 std::cout << "Document created: " << title << std::endl;
    42 }
    43 ~Document() {
    44 std::cout << "Document destroyed: " << title << std::endl;
    45 }
    46
    47 void addPage(std::shared_ptr<Page> page) {
    48 pages.push_back(page);
    49 page->document = std::shared_from_this(); // 页面反向指向文档 (weak_ptr 不影响引用计数)
    50 }
    51 };
    52
    53 int main() {
    54 { // 使用代码块限制 doc 的生命周期
    55 auto doc = std::make_shared<Document>("My Document");
    56 auto page1 = std::make_shared<Page>("Page 1 Content");
    57 auto page2 = std::make_shared<Page>("Page 2 Content");
    58
    59 doc->addPage(page1);
    60 doc->addPage(page2);
    61
    62 page1->printDocumentTitle(); // Page 'Page 1 Content' belongs to document: My Document
    63 page2->printDocumentTitle(); // Page 'Page 2 Content' belongs to document: My Document
    64 } // doc, page1, page2 超出作用域,由于 weak_ptr 打破循环引用,对象会被正确析构
    65
    66 std::cout << "程序结束" << std::endl;
    67 return 0;
    68 }

    运行上述代码,可以看到 DocumentPage 对象的创建和销毁信息,证明使用 weak_ptr 成功解决了双向关联对象之间的循环引用问题。输出结果会显示所有文档和页面的创建和析构信息,以及页面成功访问并打印了所属文档的标题。当代码块结束时,由于没有循环引用,所有智能指针的引用计数最终降为 0,对象被正确析构,避免了内存泄漏。

    3.2 对象观察者 (Object Observer)模式

    3.2.1 事件回调 (Event Callback)机制

    概述

    在事件回调 (Event Callback) 机制中,观察者 (Observer) 需要注册到被观察者 (Subject) 以监听特定事件。当事件发生时,被观察者会调用观察者的回调函数。如果回调函数需要访问观察者对象本身,并且使用 shared_ptr 来持有观察者,可能会导致被观察者和观察者之间形成循环引用,尤其当观察者的生命周期由其他部分管理时。使用 weak_ptr 可以让被观察者持有观察者的弱引用,避免影响观察者的生命周期,同时在回调时安全地访问观察者对象。

    详细解析

    考虑一个简单的事件系统,其中有一个 Button (按钮) 类作为被观察者,当按钮被点击时,会触发 onClick 事件,通知注册的观察者。观察者可以是任何实现了 OnClickListener (点击监听器) 接口的类。

    如果 Button 类使用 shared_ptr 来存储 OnClickListener,可能会导致循环引用。例如,如果 OnClickListener 对象也持有 Button 对象的 shared_ptr,或者 OnClickListener 对象的生命周期由 Button 对象直接或间接管理,就会出现问题。

    使用 weak_ptr 可以解决这个问题。Button 类可以使用 weak_ptr 来存储 OnClickListener,这样 Button 不会拥有 OnClickListener 的所有权,只是观察它。当事件发生时,Button 使用 weak_ptr::lock() 来尝试获取 OnClickListenershared_ptr,如果 OnClickListener 仍然存活,则调用回调函数;如果 OnClickListener 已经销毁,则 lock() 返回空指针,Button 不会尝试调用无效的回调函数。

    定义 OnClickListener 接口和 Button 类如下:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <functional>
    5
    6 class OnClickListener {
    7 public:
    8 virtual void onClick() = 0;
    9 virtual ~OnClickListener() = default;
    10 };
    11
    12 class Button {
    13 public:
    14 std::string name;
    15 std::weak_ptr<OnClickListener> listener; // 使用 weak_ptr 存储监听器
    16
    17 Button(std::string n) : name(n) {
    18 std::cout << "Button created: " << name << std::endl;
    19 }
    20 ~Button() {
    21 std::cout << "Button destroyed: " << name << std::endl;
    22 }
    23
    24 void setOnClickListener(std::shared_ptr<OnClickListener> l) {
    25 listener = l; // 存储监听器的 weak_ptr
    26 }
    27
    28 void click() {
    29 std::cout << "Button " << name << " clicked!" << std::endl;
    30 std::shared_ptr<OnClickListener> sharedListener = listener.lock(); // 尝试获取 shared_ptr
    31 if (sharedListener) {
    32 sharedListener->onClick(); // 如果监听器仍然有效,则调用回调函数
    33 } else {
    34 std::cout << "No valid listener attached." << std::endl; // 监听器已过期
    35 }
    36 }
    37 };
    38
    39 class MyListener : public OnClickListener {
    40 public:
    41 std::string listenerName;
    42 std::shared_ptr<Button> observedButton; // 假设监听器需要观察按钮
    43
    44 MyListener(std::string ln, std::shared_ptr<Button> button) : listenerName(ln), observedButton(button) {
    45 std::cout << "Listener created: " << listenerName << std::endl;
    46 }
    47 ~MyListener() {
    48 std::cout << "Listener destroyed: " << listenerName << std::endl;
    49 }
    50
    51 void onClick() override {
    52 std::cout << "Listener " << listenerName << " received click event from button " << observedButton->name << std::endl;
    53 }
    54 };
    55
    56 int main() {
    57 auto button = std::make_shared<Button>("Button1");
    58 { // 使用代码块限制 listener 的生命周期
    59 auto listener = std::make_shared<MyListener>("ListenerA", button);
    60 button->setOnClickListener(listener);
    61 button->click(); // 按钮被点击,监听器收到事件
    62 } // listener 超出作用域,被销毁
    63
    64 button->click(); // 按钮再次被点击,但监听器已销毁,不会调用回调函数
    65
    66 std::cout << "程序结束" << std::endl;
    67 return 0;
    68 }

    在这个例子中,Button 类使用 std::weak_ptr<OnClickListener> listener 来存储监听器。MyListener 类也持有一个 std::shared_ptr<Button> observedButton,用于演示双向关联,但关键在于 ButtonOnClickListener 的关联是弱引用。

    main 函数中的代码块结束时,listener 对象超出作用域,其 shared_ptr 引用计数降为 0,MyListener 对象被销毁。此时,button 对象仍然存活,但其持有的 listener weak_ptr 指向的对象已经过期。当再次调用 button->click() 时,listener.lock() 返回空指针,Button 类能够正确检测到监听器已经失效,避免了访问悬挂指针或调用已销毁对象的方法。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <functional>
    5
    6 class OnClickListener {
    7 public:
    8 virtual void onClick() = 0;
    9 virtual ~OnClickListener() = default;
    10 };
    11
    12 class Button {
    13 public:
    14 std::string name;
    15 std::weak_ptr<OnClickListener> listener; // 使用 weak_ptr 存储监听器
    16
    17 Button(std::string n) : name(n) {
    18 std::cout << "Button created: " << name << std::endl;
    19 }
    20 ~Button() {
    21 std::cout << "Button destroyed: " << name << std::endl;
    22 }
    23
    24 void setOnClickListener(std::shared_ptr<OnClickListener> l) {
    25 listener = l; // 存储监听器的 weak_ptr
    26 }
    27
    28 void click() {
    29 std::cout << "Button " << name << " clicked!" << std::endl;
    30 std::shared_ptr<OnClickListener> sharedListener = listener.lock(); // 尝试获取 shared_ptr
    31 if (sharedListener) {
    32 sharedListener->onClick(); // 如果监听器仍然有效,则调用回调函数
    33 } else {
    34 std::cout << "No valid listener attached or listener expired." << std::endl; // 监听器已过期
    35 }
    36 }
    37 };
    38
    39 class MyListener : public OnClickListener {
    40 public:
    41 std::string listenerName;
    42
    43 MyListener(std::string ln) : listenerName(ln) {
    44 std::cout << "Listener created: " << listenerName << std::endl;
    45 }
    46 ~MyListener() {
    47 std::cout << "Listener destroyed: " << listenerName << std::endl;
    48 }
    49
    50 void onClick() override {
    51 std::cout << "Listener " << listenerName << " received click event." << std::endl;
    52 }
    53 };
    54
    55 int main() {
    56 auto button = std::make_shared<Button>("Button1");
    57 { // 使用代码块限制 listener 的生命周期
    58 auto listener = std::make_shared<MyListener>("ListenerA");
    59 button->setOnClickListener(listener);
    60 button->click(); // 按钮被点击,监听器收到事件
    61 } // listener 超出作用域,被销毁
    62
    63 button->click(); // 按钮再次被点击,但监听器已销毁,不会调用回调函数
    64
    65 std::cout << "程序结束" << std::endl;
    66 return 0;
    67 }

    运行上述代码,可以看到,第一次点击按钮时,监听器 ListenerA 成功接收到事件并执行了回调函数。当 ListenerA 对象被销毁后,再次点击按钮时,由于 weak_ptr 指向的对象已过期,Button 类安全地处理了这种情况,没有发生错误,避免了潜在的崩溃或未定义行为。这展示了 weak_ptr 在事件回调机制中避免悬挂指针和循环引用的作用。

    3.2.2 缓存 (Cache)机制

    概述

    在缓存 (Cache) 系统中,通常需要存储一些昂贵的对象,以便后续快速访问。但是,缓存的对象不应该永久存在,当系统内存紧张或者对象不再被使用时,应该能够自动从缓存中移除。使用 weak_ptr 可以实现一种自动失效的缓存机制。缓存可以存储对象的 weak_ptr,当对象被其他地方销毁后,缓存中的 weak_ptr 会自动过期,表示缓存项无效。在访问缓存时,需要检查 weak_ptr 是否有效,如果有效则返回缓存的对象,否则表示缓存未命中。

    详细解析

    考虑一个简单的缓存系统 ObjectCache (对象缓存),用于缓存一些创建开销较大的 ExpensiveObject (昂贵对象)。ObjectCache 使用一个 std::map (映射) 来存储缓存项,键是对象的 ID,值是对象的 weak_ptr

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <map>
    4 #include <string>
    5
    6 class ExpensiveObject {
    7 public:
    8 std::string name;
    9
    10 ExpensiveObject(std::string n) : name(n) {
    11 std::cout << "ExpensiveObject created: " << name << std::endl;
    12 // 模拟昂贵的创建过程
    13 }
    14 ~ExpensiveObject() {
    15 std::cout << "ExpensiveObject destroyed: " << name << std::endl;
    16 }
    17
    18 void operation() {
    19 std::cout << "ExpensiveObject " << name << " operation." << std::endl;
    20 }
    21 };
    22
    23 class ObjectCache {
    24 public:
    25 std::map<std::string, std::weak_ptr<ExpensiveObject>> cacheMap;
    26
    27 std::shared_ptr<ExpensiveObject> getObject(const std::string& key) {
    28 std::shared_ptr<ExpensiveObject> objPtr = cacheMap[key].lock(); // 尝试从 weak_ptr 获取 shared_ptr
    29 if (!objPtr) {
    30 std::cout << "Cache miss for key: " << key << ". Creating new object." << std::endl;
    31 objPtr = std::make_shared<ExpensiveObject>(key); // 缓存未命中,创建新对象
    32 cacheMap[key] = objPtr; // 将新对象的 weak_ptr 存入缓存
    33 } else {
    34 std::cout << "Cache hit for key: " << key << "." << std::endl;
    35 }
    36 return objPtr;
    37 }
    38 };
    39
    40 int main() {
    41 ObjectCache cache;
    42 std::shared_ptr<ExpensiveObject> obj1;
    43
    44 { // 使用代码块限制 objPtr1 的生命周期
    45 std::shared_ptr<ExpensiveObject> objPtr1 = cache.getObject("Object1"); // 首次获取,缓存未命中,创建对象
    46 objPtr1->operation(); // 执行对象操作
    47 obj1 = objPtr1; // 将 shared_ptr<obj1> 赋值给外部的 obj1,延长 obj1 的生命周期
    48 } // objPtr1 超出作用域
    49
    50 std::shared_ptr<ExpensiveObject> objPtr2 = cache.getObject("Object1"); // 再次获取,缓存命中,返回缓存中的对象
    51 objPtr2->operation(); // 执行对象操作
    52
    53 std::cout << "obj1 use_count: " << obj1.use_count() << std::endl; // 检查 obj1 的引用计数,应大于 0
    54 std::cout << "objPtr2 use_count: " << objPtr2.use_count() << std::endl; // 检查 objPtr2 的引用计数,应与 obj1 相同
    55
    56 obj1.reset(); // 释放 obj1 的引用
    57
    58 std::cout << "obj1 reset, use_count: " << obj1.use_count() << std::endl; // 检查 obj1 reset 后的引用计数,应为 0
    59
    60 std::shared_ptr<ExpensiveObject> objPtr3 = cache.getObject("Object1"); // 再次获取,缓存未命中,因为对象已被销毁,weak_ptr 过期,重新创建对象
    61 objPtr3->operation(); // 执行对象操作
    62
    63 std::cout << "程序结束" << std::endl;
    64 return 0;
    65 }

    ObjectCache 类中,cacheMap 存储的是 std::weak_ptr<ExpensiveObject>。当调用 getObject(key) 时,首先尝试使用 cacheMap[key].lock() 从缓存中获取 shared_ptr

    ① 如果缓存中没有该键,或者 weak_ptr 已经过期(即指向的对象已被销毁),lock() 返回空指针,表示缓存未命中。此时,getObject() 创建一个新的 ExpensiveObject 对象,并将其 shared_ptr 存入缓存,返回新创建的 shared_ptr

    ② 如果缓存中存在该键,并且 weak_ptr 有效(即指向的对象仍然存活),lock() 返回有效的 shared_ptr,表示缓存命中。getObject() 直接返回缓存中的 shared_ptr,避免了重复创建昂贵对象。

    main 函数中,首次获取 "Object1" 时,缓存未命中,创建了 ExpensiveObject("Object1") 并存入缓存。第二次获取 "Object1" 时,缓存命中,直接返回了缓存中的 shared_ptr。之后,通过 obj1.reset() 显式地销毁了 obj1 指向的对象。最后一次获取 "Object1" 时,由于之前缓存的对象已经被销毁,缓存中的 weak_ptr 过期,缓存再次未命中,重新创建了 ExpensiveObject("Object1")

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <map>
    4 #include <string>
    5
    6 class ExpensiveObject {
    7 public:
    8 std::string name;
    9
    10 ExpensiveObject(std::string n) : name(n) {
    11 std::cout << "ExpensiveObject created: " << name << std::endl;
    12 // 模拟昂贵的创建过程
    13 }
    14 ~ExpensiveObject() {
    15 std::cout << "ExpensiveObject destroyed: " << name << std::endl;
    16 }
    17
    18 void operation() {
    19 std::cout << "ExpensiveObject " << name << " operation." << std::endl;
    20 }
    21 };
    22
    23 class ObjectCache {
    24 public:
    25 std::map<std::string, std::weak_ptr<ExpensiveObject>> cacheMap;
    26
    27 std::shared_ptr<ExpensiveObject> getObject(const std::string& key) {
    28 std::shared_ptr<ExpensiveObject> objPtr = cacheMap[key].lock(); // 尝试从 weak_ptr 获取 shared_ptr
    29 if (!objPtr) {
    30 std::cout << "Cache miss for key: " << key << ". Creating new object." << std::endl;
    31 objPtr = std::make_shared<ExpensiveObject>(key); // 缓存未命中,创建新对象
    32 cacheMap[key] = objPtr; // 将新对象的 weak_ptr 存入缓存
    33 } else {
    34 std::cout << "Cache hit for key: " << key << "." << std::endl;
    35 }
    36 return objPtr;
    37 }
    38 };
    39
    40 int main() {
    41 ObjectCache cache;
    42 std::shared_ptr<ExpensiveObject> obj1;
    43
    44 { // 使用代码块限制 objPtr1 的生命周期
    45 std::shared_ptr<ExpensiveObject> objPtr1 = cache.getObject("Object1"); // 首次获取,缓存未命中,创建对象
    46 objPtr1->operation(); // 执行对象操作
    47 obj1 = objPtr1; // 将 shared_ptr<obj1> 赋值给外部的 obj1,延长 obj1 的生命周期
    48 } // objPtr1 超出作用域
    49
    50 std::shared_ptr<ExpensiveObject> objPtr2 = cache.getObject("Object1"); // 再次获取,缓存命中,返回缓存中的对象
    51 objPtr2->operation(); // 执行对象操作
    52
    53 obj1.reset(); // 释放 obj1 的引用
    54
    55 std::shared_ptr<ExpensiveObject> objPtr3 = cache.getObject("Object1"); // 再次获取,缓存未命中,因为对象已被销毁,weak_ptr 过期,重新创建对象
    56 objPtr3->operation(); // 执行对象操作
    57
    58 std::cout << "程序结束" << std::endl;
    59 return 0;
    60 }

    运行上述代码,可以看到缓存命中和未命中的情况,以及 ExpensiveObject 对象的创建和销毁信息。这表明使用 weak_ptr 实现的缓存系统能够自动管理缓存对象的生命周期,当对象不再被其他地方引用时,缓存项自动失效,并在需要时重新创建对象,有效地利用了内存资源,提高了程序性能。

    3.3 工厂模式与对象生命周期管理 (Factory Pattern and Object Lifecycle Management)

    概述

    在工厂模式 (Factory Pattern) 中,工厂类负责创建和管理对象的生命周期。工厂方法通常返回指向新创建对象的智能指针,以便客户端代码能够安全地使用和管理对象。在某些复杂的场景下,工厂创建的对象可能需要反向引用工厂本身,或者需要被其他组件观察。为了避免循环引用和确保对象生命周期的正确管理,可以使用 weak_ptr 在工厂和其创建的对象之间建立非拥有性的关联。

    详细解析

    考虑一个简单的图形对象工厂 ShapeFactory (形状工厂),用于创建不同类型的图形对象,例如 Circle (圆形) 和 Square (正方形)。ShapeFactory 可能会维护一个已创建对象的列表,或者对象需要知道是由哪个工厂创建的。

    如果工厂和对象之间使用 shared_ptr 互相引用,可能会导致循环引用。例如,如果 ShapeFactory 持有已创建 Shape (形状) 对象的 shared_ptr 列表,而 Shape 对象也持有指向 ShapeFactoryshared_ptr,就会形成循环引用。

    使用 weak_ptr 可以解决这个问题。ShapeFactory 可以持有已创建 Shape 对象的 shared_ptr 列表,用于管理对象的生命周期。而 Shape 对象可以使用 weak_ptr 来观察创建它的 ShapeFactory,或者反之,工厂使用 weak_ptr 观察已创建的对象(如果需要)。这样可以避免循环引用,同时允许对象在需要时访问工厂的信息。

    定义 Shape 抽象基类,CircleSquare 派生类,以及 ShapeFactory 工厂类如下:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <string>
    5
    6 class Shape {
    7 public:
    8 virtual void draw() = 0;
    9 virtual ~Shape() = default;
    10 virtual std::string getType() const = 0;
    11 };
    12
    13 class Circle : public Shape {
    14 public:
    15 void draw() override {
    16 std::cout << "Drawing a Circle." << std::endl;
    17 }
    18 std::string getType() const override {
    19 return "Circle";
    20 }
    21 };
    22
    23 class Square : public Shape {
    24 public:
    25 void draw() override {
    26 std::cout << "Drawing a Square." << std::endl;
    27 }
    28 std::string getType() const override {
    29 return "Square";
    30 }
    31 };
    32
    33 class ShapeFactory {
    34 public:
    35 std::vector<std::shared_ptr<Shape>> createdShapes; // 工厂持有已创建形状的 shared_ptr 列表
    36
    37 std::shared_ptr<Shape> createShape(const std::string& type) {
    38 std::shared_ptr<Shape> shapePtr;
    39 if (type == "Circle") {
    40 shapePtr = std::make_shared<Circle>();
    41 } else if (type == "Square") {
    42 shapePtr = std::make_shared<Square>();
    43 } else {
    44 return nullptr; // Unknown shape type
    45 }
    46 createdShapes.push_back(shapePtr); // 将新创建的形状加入列表
    47 return shapePtr;
    48 }
    49
    50 void listCreatedShapes() const {
    51 std::cout << "Factory created shapes:" << std::endl;
    52 for (const auto& shapePtr : createdShapes) {
    53 std::cout << "- " << shapePtr->getType() << std::endl;
    54 }
    55 }
    56 };
    57
    58 int main() {
    59 ShapeFactory factory;
    60 std::shared_ptr<Shape> circle = factory.createShape("Circle");
    61 std::shared_ptr<Shape> square = factory.createShape("Square");
    62
    63 if (circle) circle->draw();
    64 if (square) square->draw();
    65
    66 factory.listCreatedShapes(); // 列出工厂创建的所有形状
    67
    68 std::cout << "程序结束" << std::endl;
    69 return 0;
    70 }

    在这个例子中,ShapeFactory 类使用 std::vector<std::shared_ptr<Shape>> createdShapes 来管理已创建 Shape 对象的生命周期。工厂创建的每个 Shape 对象都存储在 createdShapes 列表中,确保这些对象在工厂对象存活期间也存活。

    如果 Shape 对象需要反向引用创建它的工厂,可以将 Shape 类添加一个 std::weak_ptr<ShapeFactory> factory 成员变量,并在工厂创建对象时设置这个 weak_ptr。但在这个简单的例子中,Shape 对象并不需要直接访问工厂,工厂单方面管理对象的生命周期即可,使用 shared_ptrweak_ptr 的组合实现了工厂模式下的对象生命周期管理,避免了循环引用,并保证了资源的有效管理。

    代码示例

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <string>
    5
    6 class Shape {
    7 public:
    8 virtual void draw() = 0;
    9 virtual ~Shape() = default;
    10 virtual std::string getType() const = 0;
    11 };
    12
    13 class Circle : public Shape {
    14 public:
    15 void draw() override {
    16 std::cout << "Drawing a Circle." << std::endl;
    17 }
    18 std::string getType() const override {
    19 return "Circle";
    20 }
    21 };
    22
    23 class Square : public Shape {
    24 public:
    25 void draw() override {
    26 std::cout << "Drawing a Square." << std::endl;
    27 }
    28 std::string getType() const override {
    29 return "Square";
    30 }
    31 };
    32
    33 class ShapeFactory {
    34 public:
    35 std::vector<std::shared_ptr<Shape>> createdShapes; // 工厂持有已创建形状的 shared_ptr 列表
    36
    37 std::shared_ptr<Shape> createShape(const std::string& type) {
    38 std::shared_ptr<Shape> shapePtr;
    39 if (type == "Circle") {
    40 shapePtr = std::make_shared<Circle>();
    41 } else if (type == "Square") {
    42 shapePtr = std::make_shared<Square>();
    43 } else {
    44 return nullptr; // Unknown shape type
    45 }
    46 createdShapes.push_back(shapePtr); // 将新创建的形状加入列表
    47 return shapePtr;
    48 }
    49
    50 void listCreatedShapes() const {
    51 std::cout << "Factory created shapes:" << std::endl;
    52 for (const auto& shapePtr : createdShapes) {
    53 std::cout << "- " << shapePtr->getType() << std::endl;
    54 }
    55 }
    56 };
    57
    58 int main() {
    59 ShapeFactory factory;
    60 std::shared_ptr<Shape> circle = factory.createShape("Circle");
    61 std::shared_ptr<Shape> square = factory.createShape("Square");
    62
    63 if (circle) circle->draw();
    64 if (square) square->draw();
    65
    66 factory.listCreatedShapes(); // 列出工厂创建的所有形状
    67
    68 std::cout << "程序结束" << std::endl;
    69 return 0;
    70 }

    运行上述代码,可以看到 ShapeFactory 成功创建并管理了 CircleSquare 对象。工厂模式结合 shared_ptrweak_ptr (虽然在这个例子中没有显式使用 weak_ptr,但在更复杂的工厂模式中,可以使用 weak_ptr 来避免循环引用) 可以有效地管理对象的生命周期,确保资源的安全释放和程序的健壮性。通过工厂集中管理对象的创建和销毁,可以提高代码的可维护性和可扩展性。

    4. weak_ptr 与线程安全 (Thread Safety of weak_ptr)

    本章讨论 weak_ptr 在多线程 (Multithreading) 环境下的线程安全性 (Thread Safety) 问题,以及使用 weak_ptr 时需要注意的并发控制 (Concurrency Control)。

    4.1 weak_ptr 的线程安全级别 (Thread Safety Level of weak_ptr)

    本节明确指出 weak_ptr 本身的操作在多线程环境下是否安全,以及哪些操作需要额外的同步措施。

    weak_ptr 本身的设计目标之一就是为了在复杂的资源管理场景中提供线程安全的操作,尤其是在与 shared_ptr (共享指针) 共同工作时。 总体来说,weak_ptr自身操作在多线程环境下是相对安全的,但这并不意味着可以完全忽略线程安全问题。我们需要区分 weak_ptr 自身的操作以及它所指向的共享对象的操作。

    weak_ptr 自身的赋值、复制和析构是线程安全的。这意味着在多个线程中同时对不同的 weak_ptr 对象进行赋值、复制或销毁操作,通常不需要额外的同步机制。这是因为这些操作主要涉及 weak_ptr 对象自身的内部状态管理,而这些管理通常是原子操作 (Atomic Operation) 或使用内部锁 (Internal Lock) 来保证线程安全。

    weak_ptr::lock() 操作是线程安全的lock() 操作尝试从 weak_ptr 获取一个 shared_ptr。这个操作涉及到检查所指向的 shared_ptr 控制块 (Control Block) 的引用计数 (Reference Counting)。标准库保证 lock() 操作是线程安全的,即使多个线程同时调用同一个 weak_ptrlock() 方法,也不会导致数据竞争 (Data Race) 或未定义行为 (Undefined Behavior)。lock() 操作会原子地增加 shared_ptr 的引用计数(如果对象仍然存活),并返回一个新的 shared_ptr,或者在对象已过期时返回空指针 (nullptr)。

    weak_ptr::expired()weak_ptr::reset() 操作通常也是线程安全的expired() 用于检查 weak_ptr 是否过期,而 reset() 用于解除 weak_ptr 与其指向对象的关联。这些操作通常也设计为线程安全的,但具体实现可能依赖于编译器和标准库版本。一般而言,可以认为这些操作在多线程环境下是安全的,但最好查阅具体的编译器和标准库文档以确认。

    weak_ptr::use_count() 操作。虽然 weak_ptr 提供了 use_count() 方法来获取关联的 shared_ptr 的引用计数,但不建议依赖此方法来做线程同步use_count() 返回的引用计数值在多线程环境下可能瞬间失效,因为它返回的是一个近似值,而不是一个原子快照 (Atomic Snapshot)。因此,use_count() 的结果不应该作为线程同步的依据,仅仅可以用于调试或监控目的。如果在多线程环境中需要基于对象生命周期进行同步,应该使用更可靠的同步机制,例如互斥锁 (Mutex)、条件变量 (Condition Variable) 或原子操作。

    总结 weak_ptr 线程安全级别:

    操作线程安全级别
    weak_ptr 自身操作 (赋值、复制、析构)线程安全 # 4.2 多线程环境下的 weak_ptr 使用注意事项 (Precautions for Using weak_ptr in Multithreaded Environments)
    本节提供在多线程程序中使用 weak_ptr 的最佳实践和注意事项,避免并发问题。

    虽然 weak_ptr 的操作本身是线程安全的,但在多线程环境中使用 weak_ptr 时,仍然需要注意一些关键事项,以避免潜在的并发问题和确保程序的正确性。

    生命周期管理仍然重要 (Lifecycle Management is Still Crucial):即使使用了 weak_ptr 来打破循环引用,对象的生命周期管理仍然至关重要。weak_ptr 只是观察者,它不影响对象的销毁。如果对象被销毁,任何持有指向该对象的 weak_ptrlock() 后都会得到空指针。因此,必须确保在所有线程中对共享对象的生命周期有清晰的理解和控制

    避免悬挂 weak_ptr (Avoiding Dangling weak_ptr):尽管 weak_ptr 本身不会导致内存泄漏,但仍然可能出现悬挂 weak_ptr (Dangling weak_ptr) 的情况。当所有 shared_ptr 都被销毁,对象被释放后,再通过 weak_ptr::lock() 得到的将是空指针。这本身不是错误,但如果程序逻辑没有正确处理这种情况,可能会导致逻辑错误。因此,每次使用 weak_ptr::lock() 之后,都必须检查返回的 shared_ptr 是否为空,尤其是在多线程环境中,对象可能在任何时候被其他线程销毁。

    原子操作与数据竞争 (Atomic Operations and Data Race):虽然 weak_ptr::lock() 是原子操作,但如果通过 lock() 获取 shared_ptr 后,再对 shared_ptr 指向的对象进行非线程安全的操作,仍然会存在数据竞争的风险weak_ptr 只能保证获取 shared_ptr 的过程是安全的,但无法保证后续通过 shared_ptr 访问对象的操作也是安全的。如果需要多线程安全地访问共享对象,必须使用适当的同步机制,例如互斥锁 (Mutex) 来保护对象的状态

    观察者模式中的线程安全 (Thread Safety in Observer Pattern):在观察者模式 (Observer Pattern) 中,weak_ptr 常常被用来存储观察者列表,避免循环引用。在这种场景下,当被观察对象 (Subject) 通知观察者 (Observer) 时,需要遍历观察者列表并调用观察者的回调函数。遍历观察者列表和调用回调函数的过程需要考虑线程安全。如果观察者列表可能在其他线程中被修改(例如添加或删除观察者),则需要使用互斥锁或其他同步机制来保护对观察者列表的访问。此外,回调函数的执行也需要在线程安全的上下文中进行,如果回调函数访问了共享资源,同样需要同步保护。

    工厂模式与线程安全 (Thread Safety in Factory Pattern):在工厂模式 (Factory Pattern) 中,工厂负责创建和管理对象的生命周期。如果工厂创建的对象被多个线程共享,且工厂使用 weak_ptr 来跟踪已创建的对象,需要确保工厂的创建和管理操作是线程安全的。例如,如果工厂需要维护一个对象池 (Object Pool) 或者缓存 (Cache),对对象池或缓存的访问和更新必须是线程安全的。

    避免在析构函数中使用 weak_ptr::lock() (Avoid weak_ptr::lock() in Destructors):在对象的析构函数 (Destructor) 中调用 weak_ptr::lock()非常危险的操作,应该极力避免。析构函数执行时,对象已经被销毁或正在被销毁,此时调用 lock() 尝试获取 shared_ptr 可能会导致未定义行为。析构函数应该专注于清理对象自身的资源,而不是尝试访问可能已经被销毁的共享对象。如果需要在对象销毁时执行某些与共享对象相关的操作,应该在对象生命周期结束之前,通过其他方式(例如显式地调用一个清理函数)来完成,而不是在析构函数中。

    最佳实践总结:

    每次 weak_ptr::lock() 后,检查返回的 shared_ptr 是否为空。 这是处理对象可能已被销毁的关键步骤,尤其是在多线程环境中。
    如果需要线程安全地访问 weak_ptr 指向的共享对象,使用互斥锁或其他同步机制保护对象的状态。 weak_ptr 自身线程安全,但不保证通过它访问的对象也是线程安全的。
    在观察者模式和工厂模式等场景中使用 weak_ptr 时,确保对观察者列表和工厂管理的数据结构的访问是线程安全的。
    避免在析构函数中使用 weak_ptr::lock() 析构函数应专注于资源清理,而不是访问共享对象。
    仔细设计对象的生命周期管理策略,确保在多线程环境下对象能够被正确地创建、使用和销毁。 weak_ptr 是资源管理工具,但不能替代良好的设计和清晰的生命周期管理。
    在复杂的并发场景中,仔细评估 weak_ptr 的使用是否真的必要,并考虑其他并发编程工具和模式,例如原子操作、锁、无锁数据结构 (Lock-Free Data Structure) 等。

    通过遵循以上注意事项和最佳实践,可以在多线程环境中安全有效地使用 weak_ptr,充分发挥其在资源管理和避免循环引用方面的优势,同时避免潜在的并发问题。

    5. weak_ptr 的高级主题与最佳实践 (Advanced Topics and Best Practices of weak_ptr)

    章节概要

    本章深入探讨 weak_ptr (弱指针) 的一些高级用法和最佳实践,旨在帮助读者更熟练地运用 weak_ptr,从而显著提升代码的质量与运行效率。我们将剖析 enable_shared_from_this (从this启用共享) 与 weak_ptr 的协同工作机制,探讨自定义删除器 (Custom Deleter) 对 weak_ptr 行为的影响,分析 weak_ptr 的性能考量,并总结 weak_ptr 的最佳实践与常见误区,助力读者在实际开发中游刃有余地驾驭 weak_ptr

    5.1 enable_shared_from_this 与 weak_ptr 的配合使用 (Using enable_shared_from_this with weak_ptr)

    enable_shared_from_this (从this启用共享) 是一个非常有用的工具类,它允许你在一个通过 std::shared_ptr (共享指针) 管理生命周期的对象内部,安全地获取指向自身的 std::shared_ptr。这在某些设计模式和场景中非常有用,例如当对象需要将其自身 shared_ptr 传递给其他组件,或者在回调函数中需要持有自身 shared_ptr 时。weak_ptr (弱指针) 在 enable_shared_from_this 的机制中扮演着关键角色,确保了在对象生命周期内的安全访问,同时避免了潜在的循环引用问题。

    假设我们有一个类 MyClass,并且我们希望在 MyClass 的成员函数中返回指向对象自身的 shared_ptr。直接在成员函数中使用 std::make_shared<MyClass>(...) (创建 MyClass 对象的共享指针) 创建一个新的 shared_ptr 是不正确的,因为这会创建一个新的、独立的 shared_ptr,而不是指向 this 指针所指对象的 shared_ptr。 这会导致对象的生命周期管理混乱,甚至可能导致对象被提前析构。

    enable_shared_from_this 通过在类中继承 std::enable_shared_from_this<T> 模板类,并使用其提供的 shared_from_this() 方法,可以安全地获取到指向当前对象的 shared_ptrenable_shared_from_this 内部维护了一个 weak_ptr (弱指针),这个 weak_ptr 指向由外部 shared_ptr 管理的对象。 当你调用 shared_from_this() 时,它实际上是尝试从内部的 weak_ptr 提升 (promote) 为 shared_ptr

    以下代码示例展示了 enable_shared_from_this 的基本用法:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 class MyClass : public std::enable_shared_from_this<MyClass> {
    5 public:
    6 std::shared_ptr<MyClass> getSelf() {
    7 return shared_from_this();
    8 }
    9
    10 void printAddress() const {
    11 std::cout << "MyClass object address: " << this << std::endl;
    12 }
    13 };
    14
    15 int main() {
    16 std::shared_ptr<MyClass> ptr1 = std::make_shared<MyClass>();
    17 std::shared_ptr<MyClass> ptr2 = ptr1->getSelf();
    18
    19 std::cout << "ptr1 address: ";
    20 ptr1->printAddress();
    21 std::cout << "ptr2 address: ";
    22 ptr2->printAddress();
    23
    24 return 0;
    25 }

    代码解析:

    MyClass 类继承了 std::enable_shared_from_this<MyClass>
    getSelf() 成员函数调用了 shared_from_this() 方法,返回指向 MyClass 对象自身的 shared_ptr
    ③ 在 main() 函数中,我们首先使用 std::make_shared<MyClass>() 创建了一个 shared_ptr ptr1 来管理 MyClass 对象的生命周期。
    ④ 然后,我们通过 ptr1->getSelf() 获取了指向同一对象的另一个 shared_ptr ptr2
    ⑤ 输出结果会显示 ptr1ptr2 指向的是同一个内存地址,证明 shared_from_this() 正确地返回了指向当前对象的 shared_ptr

    重要注意事项:

    必须由 shared_ptr 管理: shared_from_this() 只有在对象已经被 shared_ptr 管理的情况下才能正常工作。 如果对象不是由 shared_ptr 管理的(例如,直接在栈上创建,或者使用 new 创建但没有立即赋值给 shared_ptr),调用 shared_from_this() 将会导致未定义行为,通常会抛出 std::bad_weak_ptr 异常。

    构造函数中避免使用: 在构造函数中调用 shared_from_this() 是不安全的,因为在构造函数完成之前,enable_shared_from_this 内部的 weak_ptr 尚未正确初始化,无法提升为有效的 shared_ptr。 应该在对象构造完成后再调用 shared_from_this()

    多线程安全: enable_shared_from_this 的实现是线程安全的。 多个线程可以同时调用同一个对象的 shared_from_this() 方法,而不会发生数据竞争。

    weak_ptrenable_shared_from_this 中的作用:

    enable_shared_from_this 内部维护了一个 weak_ptr (弱指针),这个 weak_ptr 是在对象被 shared_ptr 管理时,由 shared_ptr 的控制块 (Control Block) 初始化并指向被管理的对象。 当调用 shared_from_this() 时,它实际上是调用了内部 weak_ptrlock() 方法。 lock() 方法会尝试将 weak_ptr 提升为 shared_ptr。 如果原始对象仍然存活(即引用计数大于0),lock() 成功,返回一个新的 shared_ptr,增加引用计数;如果原始对象已经销毁(引用计数变为0),lock() 失败,返回一个空的 shared_ptr

    因此,weak_ptrenable_shared_from_this 中扮演着安全访问和生命周期管理的关键角色。 它确保了 shared_from_this() 能够安全地返回指向当前对象的 shared_ptr,而不会因为对象已经被销毁而导致悬挂指针 (Dangling Pointer) 或其他错误。 同时,由于内部使用的是 weak_ptr,而不是 shared_ptr,所以 enable_shared_from_this 不会引入额外的引用计数,也不会导致循环引用

    总结:

    enable_shared_from_thisweak_ptr 的配合使用,为在 shared_ptr 管理的对象内部安全地获取自身 shared_ptr 提供了优雅的解决方案。 weak_ptr 在其中起到了至关重要的作用,既保证了安全访问,又避免了生命周期管理上的潜在问题。 在设计需要对象自引用的类时,enable_shared_from_this 是一个值得优先考虑的工具。

    5.2 自定义删除器 (Custom Deleter) 与 weak_ptr 的关系 (Relationship between Custom Deleter and weak_ptr)

    自定义删除器 (Custom Deleter) 是 std::shared_ptr (共享指针) 和 std::unique_ptr (独占指针) 的一个强大特性,它允许用户在智能指针所管理的对象被销毁时,执行自定义的清理操作,而不是默认的 delete 操作。 自定义删除器可以用于处理各种资源管理场景,例如释放文件句柄、关闭网络连接、归还数据库连接,或者使用特定的内存释放函数等。

    weak_ptr (弱指针) 本身并不拥有对象的所有权,它只是观察 shared_ptr 所管理的对象。 因此,weak_ptr 本身不直接参与自定义删除器的调用。 自定义删除器是 shared_ptr 的属性,当最后一个指向对象的 shared_ptr 被销毁时,才会触发自定义删除器的调用。

    weak_ptr 与自定义删除器的交互主要体现在以下几点:

    weak_ptr 的存在不影响自定义删除器的触发时机: 无论是否存在指向对象的 weak_ptr,自定义删除器仍然会在最后一个 shared_ptr 析构时被调用。 weak_ptr 不会延长对象的生命周期,也不会阻止自定义删除器的执行。

    自定义删除器在对象生命周期结束时执行: 当自定义删除器被调用时,意味着对象的生命周期已经结束。 此时,所有指向该对象的 weak_ptr 都会过期 (expired)。 在自定义删除器中,不应该尝试通过 weak_ptr 访问对象,因为对象可能已经被部分或完全销毁。

    自定义删除器可以访问 shared_ptr 的控制块 (Control Block): 虽然自定义删除器主要操作的是被管理的对象,但它也间接地与 shared_ptr 的控制块 (Control Block) 关联。 控制块中存储了引用计数、weak_ptr 计数,以及可能存在的自定义删除器。 当最后一个 shared_ptr 析构时,除了调用自定义删除器(如果存在),控制块自身也会被释放。

    代码示例:自定义删除器与 weak_ptr

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 // 自定义删除器,用于打印信息
    5 void customDeleter(int* ptr) {
    6 std::cout << "Custom deleter is called for address: " << ptr << std::endl;
    7 delete ptr; // 仍然需要手动释放内存
    8 }
    9
    10 int main() {
    11 std::shared_ptr<int> sharedPtr(new int(10), customDeleter);
    12 std::weak_ptr<int> weakPtr = sharedPtr;
    13
    14 std::cout << "sharedPtr use_count: " << sharedPtr.use_count() << std::endl; // 输出 1
    15 std::cout << "weakPtr expired: " << weakPtr.expired() << std::endl; // 输出 false
    16
    17 sharedPtr.reset(); // 释放 sharedPtr 的所有权
    18
    19 std::cout << "sharedPtr use_count: " << sharedPtr.use_count() << std::endl; // 输出 0
    20 std::cout << "weakPtr expired: " << weakPtr.expired() << std::endl; // 输出 true
    21 std::cout << "After sharedPtr reset, customDeleter should be called." << std::endl;
    22
    23 return 0;
    24 }

    代码解析:

    ① 我们定义了一个自定义删除器 customDeleter,它接受一个 int* 指针作为参数,并在释放内存之前打印一条消息。
    ② 我们使用 std::shared_ptr<int> sharedPtr(new int(10), customDeleter) 创建了一个 shared_ptr,并指定了 customDeleter 作为其自定义删除器。
    ③ 我们创建了一个指向相同对象的 weak_ptr weakPtr
    ④ 在 sharedPtr.reset() 之前,sharedPtr 的引用计数为 1,weakPtr 没有过期。
    ⑤ 当我们调用 sharedPtr.reset() 释放 sharedPtr 的所有权后,由于没有其他 shared_ptr 指向该对象,最后一个 shared_ptr 析构,此时会调用 customDeleterweakPtr 变为过期状态。
    ⑥ 程序输出会显示 "Custom deleter is called..." 的消息,证明自定义删除器被成功调用。

    总结:

    weak_ptr 与自定义删除器之间是间接关联的关系。 weak_ptr 观察 shared_ptr 管理的对象,但不影响自定义删除器的触发和执行。 自定义删除器在最后一个 shared_ptr 析构时被调用,此时对象生命周期结束,所有 weak_ptr 都会过期。 理解这种关系有助于在复杂资源管理场景中正确使用 weak_ptr 和自定义删除器。 在设计自定义删除器时,需要注意它是在对象生命周期结束后执行的,不应该在其中尝试通过 weak_ptr 访问对象。

    5.3 性能考量 (Performance Considerations) 与 weak_ptr 的选择

    weak_ptr (弱指针) 作为智能指针家族的一员,在提供内存安全和解决循环引用等问题方面发挥着重要作用。 然而,与任何工具一样,了解其性能开销并进行合理的权衡至关重要。 本节将分析 weak_ptr 在性能方面的考量因素,并探讨在性能敏感场景下选择 weak_ptr 的考量。

    weak_ptr 的性能开销主要体现在以下几个方面:

    weak_ptr 的创建和销毁:

    ⚝ 创建 weak_ptr 的开销相对较小。 它主要是复制一个指针,并增加 shared_ptr 控制块 (Control Block) 中的弱引用计数 (weak count)。 弱引用计数的增加和减少通常是原子操作 (atomic operation),在多线程环境下会有一定的同步开销。
    ⚝ 销毁 weak_ptr 的开销也很小。 主要操作是减少控制块中的弱引用计数。 同样,弱引用计数的减少也可能是原子操作。

    总的来说,weak_ptr 的创建和销毁操作开销较低,通常不会成为性能瓶颈。

    weak_ptr::lock() 操作:

    weak_ptr 最常用的操作是 lock(),它尝试将 weak_ptr 提升 (promote) 为 shared_ptrlock() 操作的开销相对较高,因为它需要进行以下步骤:
    ▮▮▮▮⚝ 读取 shared_ptr 控制块中的共享引用计数 (shared count)。
    ▮▮▮▮⚝ 检查共享引用计数是否大于 0。 如果为 0,表示对象已被销毁,lock() 失败,返回空 shared_ptr
    ▮▮▮▮⚝ 如果共享引用计数大于 0,则原子性地增加共享引用计数,并返回一个新的 shared_ptr

    lock() 操作涉及到原子操作和引用计数检查,因此比普通的指针解引用操作要慢。 在高频调用的场景下,lock() 的性能开销需要考虑。

    内存占用:

    weak_ptr 本身的大小通常与裸指针 (raw pointer) 相同。
    weak_ptr 不会增加 shared_ptr 控制块的大小。 控制块中已经包含了弱引用计数,用于支持 weak_ptr 的功能。
    ⚝ 因此,weak_ptr 本身对内存占用的影响很小。

    性能敏感场景下的 weak_ptr 选择考量:

    在性能敏感的应用场景中,例如游戏开发、高性能计算、实时系统等,我们需要仔细评估 weak_ptr 的性能影响,并根据具体情况做出选择。

    循环引用避免: 如果循环引用是潜在的问题,并且可能导致内存泄漏 (Memory Leak),那么使用 weak_ptr 打破循环引用通常是值得的,即使会引入一定的性能开销。 内存泄漏的危害往往远大于 weak_ptr 的性能开销。

    对象观察者模式: 在对象观察者模式中,观察者通常使用 weak_ptr 观察被观察对象。 这种用法可以有效避免观察者持有已销毁对象的指针。 lock() 操作只在需要访问被观察对象时才会被调用,频率通常不高,性能影响较小。

    高频 lock() 操作: 如果代码中需要频繁地调用 weak_ptr::lock(),例如在循环或热点代码路径中,那么 lock() 的性能开销可能会累积起来,成为性能瓶颈。 在这种情况下,需要仔细评估是否可以使用其他设计方案来避免高频 lock() 操作。 例如,可以考虑使用事件驱动的方式,或者在对象存活期间缓存 shared_ptr,减少 lock() 的调用次数。

    替代方案:裸指针 (raw pointer) + 手动管理: 在极少数性能要求苛刻的场景下,可以考虑使用裸指针 (raw pointer) 并进行手动内存管理。 但这需要非常谨慎,容易出错,并增加代码的复杂性和维护难度。 通常情况下,优先考虑使用智能指针,而不是手动管理内存

    性能测试与分析: 在性能敏感的应用中,进行性能测试和分析是至关重要的。 通过性能测试,可以量化 weak_ptr 的性能开销,并与其他方案进行比较,从而做出基于数据的决策。 可以使用性能分析工具 (profiling tools) 来定位性能瓶颈,并优化代码。

    最佳实践:

    默认使用智能指针: 在现代 C++ 开发中,默认应该使用智能指针 (包括 shared_ptrunique_ptr) 来管理内存。 这可以显著提高代码的安全性、健壮性和可维护性。

    谨慎使用裸指针: 除非有充分的理由,否则应该避免直接使用 newdelete 进行手动内存管理。 裸指针容易导致内存泄漏、悬挂指针等问题。

    权衡性能与安全性: 在性能敏感场景下,需要在性能和安全性之间进行权衡。 通常情况下,安全性、健壮性和可维护性应该优先考虑。 只有在性能瓶颈确实是由智能指针引起的,并且有充分的证据支持时,才应该考虑使用裸指针或其他更复杂的内存管理方案。

    性能测试驱动优化: 性能优化应该基于性能测试的结果。 在优化之前,先进行性能测试,找出真正的性能瓶颈。 不要过早优化 (premature optimization),也不要盲目优化。

    总结:

    weak_ptr 的性能开销相对较低,通常不会成为性能瓶颈。 weak_ptr 的创建和销毁开销很小,主要的性能开销来自于 lock() 操作。 在性能敏感场景下,需要仔细评估 lock() 操作的频率和影响,并进行性能测试和分析,从而做出合理的选择。 在大多数情况下,使用 weak_ptr 来提高代码的安全性、健壮性和可维护性是值得的。 只有在极少数性能要求苛刻的场景下,才需要考虑其他更复杂的内存管理方案。

    5.4 weak_ptr 的最佳实践与常见误区 (Best Practices and Common Pitfalls of weak_ptr)

    5.4.1 何时使用 weak_ptr (When to Use weak_ptr)

    weak_ptr (弱指针) 并非万能的,它有其特定的适用场景。 理解何时应该使用 weak_ptr,以及何时应该避免使用,对于编写高质量的 C++ 代码至关重要。 以下是一些使用 weak_ptr 的指导原则和适用场景:

    解决循环引用 (Circular Dependency):

    ⚝ 这是 weak_ptr 最经典、最核心的应用场景。 当两个或多个对象之间存在循环引用,且都使用 shared_ptr (共享指针) 管理彼此的生命周期时,会导致循环引用,使得对象的引用计数永远无法降为 0,造成内存泄漏 (Memory Leak)。
    ⚝ 在这种情况下,应该将循环引用关系中的至少一个 shared_ptr 改为 weak_ptrweak_ptr 不会增加引用计数,从而打破循环引用,使得对象能够被正确地析构和回收。
    ⚝ 常见的循环引用场景包括:
    ▮▮▮▮⚝ 父子节点关系 (Parent-Child Relationship): 例如树形结构中,父节点拥有子节点的 shared_ptr,子节点又需要持有父节点的指针。 可以将子节点到父节点的指针改为 weak_ptr
    ▮▮▮▮⚝ 双向关联 (Bidirectional Association): 两个对象互相持有对方的 shared_ptr。 可以将其中一个方向的 shared_ptr 改为 weak_ptr

    对象观察者模式 (Object Observer Pattern):

    ⚝ 在观察者模式中,观察者 (Observer) 需要观察被观察者 (Subject) 的状态变化。 如果观察者使用 shared_ptr 持有被观察者,可能会导致被观察者无法被销毁,即使不再有其他地方引用它。
    ⚝ 使用 weak_ptr 作为观察者指向被观察者的指针,可以避免观察者影响被观察者的生命周期。 当被观察者被销毁时,观察者持有的 weak_ptr 会自动过期,观察者在访问被观察者之前需要先检查 weak_ptr 是否有效。

    缓存 (Cache) 机制:

    ⚝ 在缓存系统中,缓存对象可能需要被其他组件访问。 如果缓存使用 shared_ptr 存储缓存对象,可能会导致缓存对象一直存活,即使已经不再需要。
    ⚝ 使用 weak_ptr 在缓存中存储缓存对象,可以让缓存对象在没有其他 shared_ptr 指向时自动失效。 当从缓存中获取对象时,需要使用 lock() 检查 weak_ptr 是否有效,如果有效则返回 shared_ptr,否则表示缓存对象已失效。

    避免悬挂指针 (Dangling Pointer):

    weak_ptr 本身并不能完全避免悬挂指针,但它可以安全地检测悬挂指针。 通过 weak_ptr::lock() 操作,可以判断所指向的对象是否仍然存活。 如果 lock() 返回空 shared_ptr,则表示原始对象已经被销毁,此时 weak_ptr 相当于一个安全的空指针,避免了直接解引用悬挂指针导致的崩溃。

    何时避免使用 weak_ptr

    不需要共享所有权: 如果对象的所有权是独占的,或者只需要在有限的作用域内使用,应该优先使用 unique_ptr (独占指针) 或原始指针 (raw pointer)。 weak_ptr 的引入会增加代码的复杂性,如果不需要其特性,则没有必要使用。

    性能敏感且 lock() 操作频繁: 如果代码对性能要求非常高,并且需要频繁地调用 weak_ptr::lock(),那么 lock() 操作的开销可能会成为性能瓶颈。 在这种情况下,需要仔细评估是否可以使用其他设计方案来避免高频 lock() 操作。

    代码简洁性优先: 在一些简单的场景中,使用 weak_ptr 可能会使代码变得更加复杂和难以理解。 如果循环引用不是问题,并且使用 shared_ptrunique_ptr 能够更清晰地表达代码意图,那么可以优先选择更简单的智能指针。

    总结:

    weak_ptr 主要用于解决循环引用、实现对象观察者模式、构建缓存机制,以及安全地检测对象是否存活。 在选择是否使用 weak_ptr 时,需要权衡其带来的好处(解决循环引用、避免内存泄漏、安全访问)和潜在的开销(代码复杂性、lock() 操作性能)。 在没有明确需求的情况下,不要过度使用 weak_ptr。 优先考虑使用 unique_ptrshared_ptr,只有在需要 weak_ptr 的特定功能时才引入它。

    5.4.2 避免 dangling weak_ptr (Avoiding Dangling weak_ptr)

    “Dangling weak_ptr” (悬挂弱指针) 本身并不是一个完全准确的术语,因为 weak_ptr 的设计目的之一就是处理所指向对象可能已被销毁的情况。 更准确的说法是“过期的 weak_ptr” (expired weak_ptr),即 weak_ptr 指向的对象已经被销毁,此时 weak_ptr::expired() 返回 trueweak_ptr::lock() 返回空 shared_ptr

    weak_ptr 的核心价值之一就是能够安全地处理对象可能已被销毁的情况,避免悬挂指针 (Dangling Pointer) 的风险。weak_ptr::lock() 返回空 shared_ptr 时,这不是错误,而是 weak_ptr 的正常行为,表示对象已经被销毁,应该按照业务逻辑进行相应的处理。

    如何正确处理和“避免” 过期 weak_ptr(实际上是正确处理过期状态):

    在使用 weak_ptr 之前始终检查其有效性:

    ⚝ 这是使用 weak_ptr最基本、最重要的原则。 在尝试通过 weak_ptr 访问对象之前,必须先使用 weak_ptr::lock() 将其提升为 shared_ptr,并检查返回的 shared_ptr 是否为空。
    ⚝ 如果 lock() 返回空 shared_ptr,则表示 weak_ptr 指向的对象已经被销毁,此时不应该尝试访问对象。 应该根据业务逻辑进行相应的处理,例如忽略操作、返回错误、重新获取对象等。

    代码示例:安全地使用 weak_ptr

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3
    4 class MyClass {
    5 public:
    6 void doSomething() {
    7 std::cout << "MyClass::doSomething() is called." << std::endl;
    8 }
    9 };
    10
    11 int main() {
    12 std::shared_ptr<MyClass> sharedPtr = std::make_shared<MyClass>();
    13 std::weak_ptr<MyClass> weakPtr = sharedPtr;
    14
    15 // 模拟 sharedPtr 被销毁
    16 sharedPtr.reset();
    17
    18 std::shared_ptr<MyClass> lockedPtr = weakPtr.lock(); // 尝试提升为 shared_ptr
    19 if (lockedPtr) {
    20 // 如果 lockedPtr 不为空,表示对象仍然存活,可以安全访问
    21 lockedPtr->doSomething();
    22 } else {
    23 // 如果 lockedPtr 为空,表示对象已被销毁,需要处理过期情况
    24 std::cout << "Object has been destroyed, weak_ptr is expired." << std::endl;
    25 }
    26
    27 return 0;
    28 }

    代码解析:

    ① 我们创建了一个 shared_ptr sharedPtr 和一个 weak_ptr weakPtr,它们都指向 MyClass 对象。
    ② 我们通过 sharedPtr.reset() 模拟了 sharedPtr 被销毁的情况,此时 MyClass 对象也应该被析构。
    ③ 我们使用 weakPtr.lock() 尝试将 weakPtr 提升为 shared_ptr,并将结果赋值给 lockedPtr
    ④ 我们检查 lockedPtr 是否为空。 如果 lockedPtr 不为空,表示 weakPtr 仍然有效,可以安全地通过 lockedPtr 访问 MyClass 对象。 如果 lockedPtr 为空,表示 weakPtr 已经过期,对象已被销毁,我们打印一条消息提示对象已销毁。

    设计合理的生命周期管理策略:

    ⚝ 避免在对象已经被销毁后,仍然持有指向该对象的 weak_ptr 并在之后尝试访问。 这通常意味着需要仔细设计对象的生命周期管理策略,确保在对象不再需要时及时释放其所有权 (shared_ptr),从而让对象能够被析构。
    ⚝ 在某些场景下,可以使用更细粒度的生命周期管理,例如使用更小的对象单元,或者使用对象池 (Object Pool) 等技术,来减少对象的生命周期,并降低 weak_ptr 过期的概率。

    避免长时间持有过期 weak_ptr

    ⚝ 虽然持有过期的 weak_ptr 本身不会导致错误,但如果长时间持有大量的过期 weak_ptr,可能会增加内存占用 (虽然 weak_ptr 本身内存占用很小,但如果数量巨大,累积起来也会有一定影响)。 并且,持有过期的 weak_ptr 也可能降低代码的可读性和可维护性
    ⚝ 在某些情况下,可以考虑定期清理或重置过期的 weak_ptr,尤其是在 weak_ptr 的生命周期可以预测的情况下。 例如,在缓存系统中,当缓存对象失效时,可以同时清理或重置指向该对象的 weak_ptr

    总结:

    “避免 dangling weak_ptr” 的核心在于正确处理 weak_ptr 的过期状态,而不是完全避免过期。 weak_ptr 的过期是正常现象,表示对象已经被销毁。 关键是在使用 weak_ptr 之前始终检查其有效性 (lock() 返回值),并根据业务逻辑处理对象已被销毁的情况。 同时,设计合理的生命周期管理策略,并避免长时间持有大量过期 weak_ptr,可以使代码更加健壮和高效。 weak_ptr 的价值在于安全地观察对象,并在对象销毁后优雅地处理过期状态,而不是避免过期本身。

    6. 案例分析:使用 weak_ptr 构建复杂系统 (Case Study: Building Complex Systems with weak_ptr)

    本章将通过一个综合性的案例,展示如何在复杂系统设计中有效利用 weak_ptr (弱指针) 进行资源管理,并优雅地解决循环引用 (Circular Dependency) 问题。我们将以一个图形编辑器 (Graphics Editor) 为例,深入探讨如何在实际项目中应用 weak_ptr,以提升系统的健壮性和可维护性。

    6.1 案例背景:一个图形编辑器 (Case Background: A Graphics Editor)

    图形编辑器是一个典型的复杂系统,它涉及到多种类型的对象以及它们之间错综复杂的关系。例如,一个图形编辑器通常包含以下核心组件:

    文档 (Document): 代表用户正在编辑的单个文件,它拥有所有图层和图形对象。
    图层 (Layer): 用于组织图形对象的容器,允许用户分层管理和操作图形元素。一个文档可以包含多个图层。
    图形对象 (Shape): 基本的绘图元素,例如矩形 (Rectangle)、圆形 (Circle)、路径 (Path) 等。每个图形对象都属于一个图层。
    组 (Group): 允许将多个图形对象或图层组合成一个单元进行操作。组可以嵌套,形成复杂的层级结构。
    选择管理器 (Selection Manager): 负责跟踪当前用户选中的图形对象,并提供选择操作的接口。
    命令历史 (Command History): 用于实现撤销 (Undo) 和重做 (Redo) 功能,记录用户的操作历史。

    这些组件之间存在着复杂的关联关系。例如:

    ⚝ 文档拥有图层和顶层组。
    ⚝ 图层拥有图形对象和子组。
    ⚝ 组可以拥有图形对象和子组。
    ⚝ 图形对象属于某个图层或组。
    ⚝ 选择管理器需要访问文档中的图形对象。
    ⚝ 命令历史需要记录对文档、图层和图形对象的操作。

    在这样的系统中,如果使用 shared_ptr (共享指针) 来管理这些对象之间的所有权关系,很容易陷入循环引用的陷阱。例如,考虑图层和图形对象之间的关系:图层拥有图形对象,而图形对象可能需要反向引用其所属的图层(例如,在事件处理或属性访问时)。如果图层使用 shared_ptr 持有图形对象,而图形对象也使用 shared_ptr 反向持有图层,就会形成循环引用,导致内存泄漏 (Memory Leak)。

    此外,图形编辑器还需要处理对象的生命周期管理。例如,当用户关闭文档时,所有相关的图层、图形对象和组都应该被正确地销毁。使用 weak_ptr 可以帮助我们打破循环引用,并实现灵活的对象生命周期管理,确保资源的正确释放。

    因此,图形编辑器是一个非常适合用来演示 weak_ptr 应用的案例。接下来,我们将详细设计图形编辑器的核心组件,并展示如何巧妙地运用 weak_ptr 来管理对象之间的关系,避免循环引用,并提升系统的整体设计质量。

    6.2 系统设计与 weak_ptr 的应用 (System Design and Application of weak_ptr)

    为了清晰地展示 weak_ptr 的应用,我们将重点关注图形编辑器中几个关键组件的设计,并解释如何在这些组件中使用 weak_ptr 来管理对象关系。

    ① 文档 (Document) 与 图层 (Layer) 的关系

    文档 (Document) 拥有多个图层 (Layer)。文档负责创建和销毁图层。图层需要知道它所属的文档,以便访问文档级别的资源或执行文档级别的操作。

    文档类 (Document Class) 可以使用 std::vector<std::shared_ptr<Layer>> 来持有图层。shared_ptr 表明文档拥有图层的生命周期。
    图层类 (Layer Class) 可以使用 std::weak_ptr<Document> 来引用其所属的文档。weak_ptr 表明图层不拥有文档的生命周期,只是需要观察文档是否存在。

    这样的设计避免了文档和图层之间的循环引用。文档拥有图层,而图层只是弱引用文档,不会增加文档的引用计数 (Reference Counting)。

    代码示例:文档和图层的类定义

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <memory>
    2 #include <vector>
    3 #include <string>
    4
    5 class Document; // 前向声明 (Forward Declaration)
    6
    7 class Layer {
    8 public:
    9 Layer(const std::string& name, std::shared_ptr<Document> doc) : name_(name), document_(doc) {}
    10 std::string getName() const { return name_; }
    11 std::shared_ptr<Document> getDocument() const {
    12 return document_.lock(); // 使用 lock() 获取 shared_ptr,可能返回 nullptr
    13 }
    14 private:
    15 std::string name_;
    16 std::weak_ptr<Document> document_; // weak_ptr 引用文档
    17 };
    18
    19 class Document {
    20 public:
    21 Document(const std::string& title) : title_(title) {}
    22 std::string getTitle() const { return title_; }
    23 void addLayer(const std::string& layerName) {
    24 layers_.emplace_back(std::make_shared<Layer>(layerName, shared_from_this())); // 使用 shared_from_this() 获取自身的 shared_ptr
    25 }
    26 const std::vector<std::shared_ptr<Layer>>& getLayers() const { return layers_; }
    27
    28 private:
    29 std::string title_;
    30 std::vector<std::shared_ptr<Layer>> layers_; // shared_ptr 拥有图层
    31 };
    32
    33 // 为了使用 enable_shared_from_this,Document 需要继承自 std::enable_shared_from_this
    34 class Document : public std::enable_shared_from_this<Document> {
    35 public:
    36 // ... (其余代码不变)
    37 };

    代码分析:

    Layer 类使用 std::weak_ptr<Document> document_ 来存储指向 Document 的弱指针。
    Layer::getDocument() 方法使用 document_.lock() 来尝试获取一个 std::shared_ptr<Document>。如果文档对象仍然存在,lock() 会返回一个有效的 shared_ptr,否则返回 nullptr (空指针),表明文档对象已经被销毁。
    Document 类使用 std::vector<std::shared_ptr<Layer>> layers_ 来存储图层,表示文档拥有图层。
    Document::addLayer() 方法在创建 Layer 对象时,使用了 shared_from_this()。为了使用 shared_from_this()Document 类需要继承自 std::enable_shared_from_this<Document>shared_from_this() 方法安全地返回指向当前 Document 对象的 shared_ptr

    ② 图层 (Layer) 与 图形对象 (Shape) 的关系

    图层 (Layer) 拥有多个图形对象 (Shape)。图层负责管理其包含的图形对象的生命周期。图形对象需要知道它所属的图层,以便进行渲染 (Rendering) 或事件处理。

    图层类 (Layer Class) 可以使用 std::vector<std::shared_ptr<Shape>> 来持有图形对象。shared_ptr 表明图层拥有图形对象的生命周期。
    图形对象类 (Shape Class) 可以使用 std::weak_ptr<Layer> 来引用其所属的图层。weak_ptr 表明图形对象不拥有图层的生命周期,只是需要观察图层是否存在。

    同样,这种设计避免了图层和图形对象之间的循环引用。

    代码示例:图层和图形对象的类定义 (简化版)

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <memory>
    2 #include <vector>
    3 #include <string>
    4
    5 class Layer; // 前向声明
    6
    7 class Shape {
    8 public:
    9 Shape(const std::string& type, std::shared_ptr<Layer> layer) : type_(type), layer_(layer) {}
    10 std::string getType() const { return type_; }
    11 std::shared_ptr<Layer> getLayer() const {
    12 return layer_.lock(); // 使用 lock() 获取 shared_ptr
    13 }
    14 virtual void draw() = 0; // 纯虚函数 (Pure Virtual Function) for drawing
    15 private:
    16 std::string type_;
    17 std::weak_ptr<Layer> layer_; // weak_ptr 引用图层
    18 };
    19
    20 class Layer {
    21 public:
    22 Layer(const std::string& name) : name_(name) {}
    23 std::string getName() const { return name_; }
    24 void addShape(std::shared_ptr<Shape> shape) {
    25 shapes_.push_back(shape);
    26 }
    27 void drawAllShapes() const {
    28 for (const auto& shape : shapes_) {
    29 shape->draw();
    30 }
    31 }
    32 private:
    33 std::string name_;
    34 std::vector<std::shared_ptr<Shape>> shapes_; // shared_ptr 拥有图形对象
    35 };
    36
    37 // 示例图形对象:矩形 (Rectangle)
    38 class Rectangle : public Shape {
    39 public:
    40 Rectangle(double width, double height, std::shared_ptr<Layer> layer)
    41 : Shape("Rectangle", layer), width_(width), height_(height) {}
    42 void draw() override {
    43 // 实际的绘制矩形的代码 (Rendering code for rectangle)
    44 std::cout << "Drawing Rectangle: width=" << width_ << ", height=" << height_ << std::endl;
    45 }
    46 private:
    47 double width_;
    48 double height_;
    49 };

    代码分析:

    Shape 类使用 std::weak_ptr<Layer> layer_ 弱引用所属的 Layer
    Shape::getLayer() 使用 layer_.lock() 获取 shared_ptr<Layer>
    Layer 类使用 std::vector<std::shared_ptr<Shape>> shapes_ 强引用其包含的 Shape 对象。
    Rectangle 类继承自 Shape 类,并实现了 draw() 方法。

    ③ 选择管理器 (Selection Manager) 与 图形对象 (Shape) 的关系

    选择管理器 (Selection Manager) 需要跟踪当前用户选中的图形对象 (Shape)。选择管理器并不拥有图形对象的生命周期,它只是观察当前的选择状态。

    选择管理器类 (SelectionManager Class) 可以使用 std::vector<std::weak_ptr<Shape>> 来存储当前选中的图形对象的弱指针。weak_ptr 表明选择管理器不拥有图形对象的生命周期,只是观察它们是否存在。

    当图形对象被销毁时,选择管理器持有的 weak_ptr 会过期,选择管理器需要定期清理过期的弱指针,以保持选择状态的有效性。

    代码示例:选择管理器类定义 (简化版)

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <memory>
    2 #include <vector>
    3
    4 class Shape; // 前向声明
    5
    6 class SelectionManager {
    7 public:
    8 void selectShape(std::shared_ptr<Shape> shape) {
    9 selectedShapes_.push_back(shape); // 直接存储 shared_ptr,选择时增加引用计数
    10 }
    11 void deselectShape(std::shared_ptr<Shape> shape) {
    12 for (auto it = selectedShapes_.begin(); it != selectedShapes_.end(); ++it) {
    13 if (*it == shape) {
    14 selectedShapes_.erase(it);
    15 return;
    16 }
    17 }
    18 }
    19 void clearSelection() {
    20 selectedShapes_.clear();
    21 }
    22 std::vector<std::shared_ptr<Shape>> getSelectedShapes() const {
    23 std::vector<std::shared_ptr<Shape>> validShapes;
    24 for (const auto& weakShape : selectedShapes_) {
    25 if (auto sharedShape = weakShape.lock()) { // 尝试 lock()
    26 validShapes.push_back(sharedShape); // 只添加有效的 shared_ptr
    27 }
    28 }
    29 return validShapes;
    30 }
    31 private:
    32 std::vector<std::weak_ptr<Shape>> selectedShapes_; // weak_ptr 观察选中的图形对象
    33 };

    代码分析:

    SelectionManager 类使用 std::vector<std::weak_ptr<Shape>> selectedShapes_ 来存储弱指针,观察选中的图形对象。
    SelectionManager::getSelectedShapes() 方法遍历 selectedShapes_,并使用 weakShape.lock() 检查弱指针是否过期。只有当 lock() 返回有效的 shared_ptr 时,才将其添加到 validShapes 向量中,最终返回有效的选中图形对象的 shared_ptr 列表。

    通过以上三个关键组件的设计,我们展示了如何在图形编辑器中使用 weak_ptr 来管理对象之间的关系,有效地避免了循环引用,并实现了清晰的对象所有权和生命周期管理。在实际的图形编辑器系统中,还有更多的组件和更复杂的关系,但 weak_ptr 的应用原则是相同的:对于不需要拥有对象生命周期的关系,使用 weak_ptr 进行观察和访问,打破潜在的循环引用。

    6.3 代码实现与分析 (Code Implementation and Analysis)

    为了更具体地展示 weak_ptr 在图形编辑器案例中的应用,我们提供一个简化的代码示例,演示如何创建文档、图层、图形对象,以及如何使用选择管理器进行对象选择和访问。

    完整代码示例 (简化版):

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 #include <iostream>
    2 #include <memory>
    3 #include <vector>
    4 #include <string>
    5
    6 // 前向声明 (Forward Declarations)
    7 class Document;
    8 class Layer;
    9 class Shape;
    10 class Rectangle;
    11 class SelectionManager;
    12
    13 // Layer 类定义 (Layer Class Definition)
    14 class Layer {
    15 public:
    16 Layer(const std::string& name) : name_(name) {}
    17 std::string getName() const { return name_; }
    18 void addShape(std::shared_ptr<Shape> shape) {
    19 shapes_.push_back(shape);
    20 }
    21 void drawAllShapes() const {
    22 for (const auto& shape : shapes_) {
    23 shape->draw();
    24 }
    25 }
    26 private:
    27 std::string name_;
    28 std::vector<std::shared_ptr<Shape>> shapes_; // shared_ptr 拥有图形对象
    29 };
    30
    31 // Shape 类定义 (Shape Class Definition)
    32 class Shape {
    33 public:
    34 Shape(const std::string& type, std::shared_ptr<Layer> layer) : type_(type), layer_(layer) {}
    35 std::string getType() const { return type_; }
    36 std::shared_ptr<Layer> getLayer() const {
    37 return layer_.lock();
    38 }
    39 virtual void draw() = 0;
    40 private:
    41 std::string type_;
    42 std::weak_ptr<Layer> layer_; // weak_ptr 引用图层
    43 };
    44
    45 // Rectangle 类定义 (Rectangle Class Definition)
    46 class Rectangle : public Shape {
    47 public:
    48 Rectangle(double width, double height, std::shared_ptr<Layer> layer)
    49 : Shape("Rectangle", layer), width_(width), height_(height) {}
    50 void draw() override {
    51 std::cout << "Drawing Rectangle: width=" << width_ << ", height=" << height_ << std::endl;
    52 }
    53 private:
    54 double width_;
    55 double height_;
    56 };
    57
    58 // Document 类定义 (Document Class Definition)
    59 class Document : public std::enable_shared_from_this<Document> {
    60 public:
    61 Document(const std::string& title) : title_(title) {}
    62 std::string getTitle() const { return title_; }
    63 std::shared_ptr<Layer> createLayer(const std::string& layerName) {
    64 auto newLayer = std::make_shared<Layer>(layerName);
    65 layers_.emplace_back(newLayer);
    66 return newLayer;
    67 }
    68 const std::vector<std::shared_ptr<Layer>>& getLayers() const { return layers_; }
    69
    70 private:
    71 std::string title_;
    72 std::vector<std::shared_ptr<Layer>> layers_; // shared_ptr 拥有图层
    73 };
    74
    75 // SelectionManager 类定义 (SelectionManager Class Definition)
    76 class SelectionManager {
    77 public:
    78 void selectShape(std::shared_ptr<Shape> shape) {
    79 selectedShapes_.push_back(shape);
    80 }
    81 void deselectShape(std::shared_ptr<Shape> shape) {
    82 for (auto it = selectedShapes_.begin(); it != selectedShapes_.end(); ++it) {
    83 if (*it == shape) {
    84 selectedShapes_.erase(it);
    85 return;
    86 }
    87 }
    88 }
    89 void clearSelection() {
    90 selectedShapes_.clear();
    91 }
    92 std::vector<std::shared_ptr<Shape>> getSelectedShapes() const {
    93 std::vector<std::shared_ptr<Shape>> validShapes;
    94 for (const auto& weakShape : selectedShapes_) {
    95 if (auto sharedShape = weakShape.lock()) {
    96 validShapes.push_back(sharedShape);
    97 }
    98 }
    99 return validShapes;
    100 }
    101 private:
    102 std::vector<std::weak_ptr<Shape>> selectedShapes_; // weak_ptr 观察选中的图形对象
    103 };
    104
    105
    106 int main() {
    107 // 创建文档 (Create Document)
    108 auto doc = std::make_shared<Document>("My Graphics Document");
    109 std::cout << "Document created: " << doc->getTitle() << std::endl;
    110
    111 // 创建图层 (Create Layers)
    112 auto layer1 = doc->createLayer("Layer 1");
    113 auto layer2 = doc->createLayer("Layer 2");
    114 std::cout << "Layers created: " << layer1->getName() << ", " << layer2->getName() << std::endl;
    115
    116 // 创建图形对象 (Create Shapes)
    117 auto rect1 = std::make_shared<Rectangle>(10, 20, layer1);
    118 auto rect2 = std::make_shared<Rectangle>(30, 40, layer2);
    119 layer1->addShape(rect1);
    120 layer2->addShape(rect2);
    121 std::cout << "Shapes created and added to layers." << std::endl;
    122
    123 // 绘制所有图层的所有图形对象 (Draw all shapes in all layers)
    124 std::cout << "\nDrawing all shapes:" << std::endl;
    125 for (const auto& layer : doc->getLayers()) {
    126 std::cout << "Layer: " << layer->getName() << std::endl;
    127 layer->drawAllShapes();
    128 }
    129
    130 // 选择管理器 (Selection Manager)
    131 SelectionManager selectionMgr;
    132 selectionMgr.selectShape(rect1);
    133 selectionMgr.selectShape(rect2);
    134 std::cout << "\nSelected shapes:" << std::endl;
    135 for (const auto& shape : selectionMgr.getSelectedShapes()) {
    136 std::cout << "Selected Shape Type: " << shape->getType() << std::endl;
    137 }
    138
    139 return 0;
    140 }

    代码分析:

    main() 函数演示了图形编辑器的基本使用流程:创建文档、图层、图形对象,并将图形对象添加到图层,最后使用选择管理器选择图形对象。
    ⚝ 代码中清晰地展示了 shared_ptr 如何管理文档、图层和图形对象的所有权关系,以及 weak_ptr 如何在 ShapeSelectionManager 中作为观察者,避免循环引用。
    ⚝ 通过运行这段代码,可以验证系统的基本功能,并理解 weak_ptr 在实际应用中的作用。

    总结:

    本章通过图形编辑器案例,深入探讨了 weak_ptr 在复杂系统设计中的应用。我们展示了如何使用 weak_ptr 来打破对象之间的循环引用,实现灵活的对象生命周期管理,并提高系统的健壮性和可维护性。在实际的 C++ 项目开发中,尤其是在设计具有复杂对象关系和资源管理的系统时,熟练掌握和合理运用 weak_ptr 是至关重要的。通过本章的学习,读者应该能够更好地理解 weak_ptr 的价值,并在自己的项目中有效地应用它。

    Appendix A: C++ 智能指针相关标准文档 (Standard Documents for C++ Smart Pointers)

    Appendix A1: C++ 标准文档 (C++ Standard Documents)

    本节列出 C++ 国际标准中关于智能指针(Smart Pointer),特别是 weak_ptr (弱指针) 的相关规范文档。这些文档是学习和理解 weak_ptr 最权威的资料来源。

    ISO/IEC 14882 - Programming Language C++

    ▮ 这是 C++ 编程语言的国际标准,由国际标准化组织(ISO)和国际电工委员会(IEC)联合发布。最新的版本是 ISO/IEC 14882:2020 (C++20 标准)。之前的版本包括 C++17, C++14, C++11 和 C++03。智能指针,包括 weak_ptr,最初在 C++11 标准中被正式引入。

    内容概要: 在 ISO/IEC 14882 标准文档中,关于智能指针和 weak_ptr 的定义和规范主要分布在以下章节(具体章节号可能随标准版本略有变动,请参考对应版本的标准文档):

    ▮▮▮▮ⓐ [20.11] Memory management library [memory.syn]: 内存管理库的概要,包含了 <memory> 头文件的声明,智能指针相关的类都定义在这个头文件中。

    ▮▮▮▮ⓑ [20.11.3] Smart pointers [memory.smartptr]: 智能指针的详细规范,这是理解 weak_ptr 的核心章节。这个部分进一步细分为:

    ▮▮▮▮▮▮▮▮❶ [20.11.3.1] Class template shared_ptr [memory.shared_ptr]: shared_ptr (共享指针) 类模板的定义、成员函数、以及相关操作的详细规范。weak_ptr 的行为与 shared_ptr 紧密相关,理解 shared_ptr 是理解 weak_ptr 的基础。

    ▮▮▮▮▮▮▮▮❷ [20.11.3.2] Class template weak_ptr [memory.weakptr]: weak_ptr (弱指针) 类模板的定义、成员函数、以及相关操作的详细规范。这是直接描述 weak_ptr 的最权威文档。你需要仔细阅读此部分,了解 weak_ptr 的构造、析构、lock() (加锁)、expired() (过期检查) 等关键操作的语义和行为。

    ▮▮▮▮ⓒ [20.11.3.3] Class template enable_shared_from_this [memory.eshared]: enable_shared_from_this 类模板的规范,它允许安全地在一个对象内部创建指向自身的 shared_ptr。这通常与 weak_ptr 结合使用,以避免生命周期管理中的错误。

    如何获取: ISO/IEC 14882 标准文档通常不是免费公开的。你可以通过以下途径获取:

    ▮▮▮▮ⓐ ISO 官方网站: 访问 ISO 官方网站 (www.iso.org),搜索 "ISO/IEC 14882" 并购买最新的 C++ 标准文档或之前的版本。

    ▮▮▮▮ⓑ 国家标准机构: 许多国家或地区的标准机构(例如中国的国家标准化管理委员会)会购买 ISO 标准,并可能提供本地化的版本或销售渠道。

    ▮▮▮▮ⓒ 大学图书馆或研究机构: 大学图书馆或研究机构通常会订阅各种标准文档数据库,你可能可以通过这些机构的资源访问到 C++ 标准文档。

    C++ 标准草案 (Working Drafts of the C++ Standard)

    ▮ 在正式的 ISO 标准发布之前,C++ 标准委员会会发布多个草案版本(Working Drafts)。这些草案反映了标准制定的最新进展,虽然不是最终的正式标准,但通常非常接近最终版本,并且是公开可用的。

    内容概要: C++ 标准草案的内容结构与最终的 ISO 标准文档非常相似,关于智能指针和 weak_ptr 的章节和内容基本一致。草案版本可以帮助你了解标准的演进过程,以及最新的语言特性。

    如何获取: 你可以从 C++ 标准委员会的官方网站或者镜像站点下载最新的 C++ 标准草案。一个常用的资源是 GitHub 上的 cplusplus/draft 仓库 (https://github.com/cplusplus/draft)。

    Appendix A2: cppreference.com - C++ 在线参考手册 (cppreference.com - Online C++ Reference)

    cppreference.com (https://en.cppreference.com/w/cpp) 是一个非常受欢迎且权威的 C++ 语言和标准库的在线参考手册。它不是官方标准文档,但它以清晰、易懂的方式解释了 C++ 的各种特性,包括智能指针。对于快速查询和学习 weak_ptr 的用法,cppreference.com 是一个非常有用的资源。

    weak_ptr - cppreference.com

    ▮ 在 cppreference.com 上搜索 "weak_ptr",你将找到关于 std::weak_ptr 的详细页面 (https://en.cppreference.com/w/cpp/memory/weak_ptr)。

    内容概要: 这个页面通常包含以下内容:

    ▮▮▮▮ⓐ weak_ptr 的定义: std::weak_ptr 类模板的声明和基本概念的介绍。

    ▮▮▮▮ⓑ 成员函数: 详细列出并解释 weak_ptr 的所有成员函数,例如:

    ▮▮▮▮▮▮▮▮❶ 构造函数 (Constructors):各种构造 weak_ptr 对象的方法。
    ▮▮▮▮▮▮▮▮❷ 析构函数 (Destructor)weak_ptr 对象的销毁过程。
    ▮▮▮▮▮▮▮▮❸ lock(): 尝试获取 shared_ptr 的关键操作。
    ▮▮▮▮▮▮▮▮❹ expired(): 检查 weak_ptr 是否过期的函数。
    ▮▮▮▮▮▮▮▮❺ reset(): 重置 weak_ptr 的操作。
    ▮▮▮▮▮▮▮▮❻ use_count(): 获取关联的 shared_ptr 的引用计数(注意 weak_ptr 不增加引用计数)。
    ▮▮▮▮▮▮▮▮❼ operator= (赋值运算符)weak_ptr 的赋值操作。

    ▮▮▮▮ⓒ 示例代码: 提供清晰的代码示例,展示 weak_ptr 的基本用法和常见应用场景,例如如何使用 weak_ptr 解决循环引用问题。

    ▮▮▮▮ⓓ 版本信息: 指出 weak_ptr 是在哪个 C++ 标准版本中引入的 (C++11)。

    优点:

    ▮▮▮▮ⓐ 易于访问: 在线免费访问,无需购买或订阅。
    ▮▮▮▮ⓑ 内容丰富: 涵盖了 weak_ptr 的各个方面,从基本概念到高级用法。
    ▮▮▮▮ⓒ 示例清晰: 提供大量可运行的代码示例,帮助理解。
    ▮▮▮▮ⓓ 更新及时: 通常会随着 C++ 标准的更新而及时更新内容。
    ▮▮▮▮ⓔ 多语言版本: 提供多种语言版本,方便不同语言的开发者使用。

    shared_ptr - cppreference.com

    ▮ 同样,在 cppreference.com 上搜索 "shared_ptr",可以找到 std::shared_ptr 的详细页面 (https://en.cppreference.com/w/cpp/memory/shared_ptr)。理解 shared_ptr 对于深入理解 weak_ptr 至关重要。

    enable_shared_from_this - cppreference.com

    ▮ 搜索 "enable_shared_from_this",可以找到 std::enable_shared_from_this 的页面 (https://en.cppreference.com/w/cpp/memory/enable_shared_from_this),了解它与 weak_ptrshared_ptr 的协同工作方式。

    Appendix A3: 其他在线资源 (Other Online Resources)

    除了 cppreference.com,还有一些其他的在线资源也提供了关于 C++ 智能指针和 weak_ptr 的信息,例如:

    cplusplus.com - C++ Library Reference

    ▮ cplusplus.com (http://www.cplusplus.com/reference/memory/weak_ptr/) 也提供了 C++ 标准库的在线参考,包括 weak_ptr 的文档。内容相对简洁,但也是一个快速查询的资源。

    Stack Overflow 和 C++ 社区论坛

    ▮ Stack Overflow (stackoverflow.com) 和其他 C++ 社区论坛(如 Reddit 的 r/cpp)是解决实际编程问题的好去处。你可以在这些平台上搜索关于 weak_ptr 的问题和解答,或者提问你遇到的问题。

    博客文章和教程

    ▮ 许多 C++ 专家和爱好者会在博客上撰写关于智能指针和内存管理的文章和教程。通过搜索引擎搜索 "C++ weak_ptr tutorial" 或 "C++ smart pointers explained",可以找到大量的学习资料。但请注意筛选信息的质量,优先选择权威博客或知名技术网站的文章。

    总结:

    本附录列出了一些重要的 C++ 智能指针和 weak_ptr 的标准文档和参考资源。通过查阅这些资料,你可以更深入地了解 weak_ptr 的原理、用法和最佳实践。建议读者结合本书的内容,参考这些原始文档和在线资源,进行更全面的学习和探索。 📚🔍

    Appendix B: 常用工具与调试技巧 (Common Tools and Debugging Techniques)

    介绍一些用于分析和调试智能指针问题的工具和技巧,帮助读者更好地排查和解决 weak_ptr 相关的问题。

    在 C++ 开发中,智能指针极大地简化了内存管理,但当出现问题时,特别是涉及到 weak_ptr 这类非拥有性指针时,调试可能会变得复杂。本附录旨在介绍一些实用的工具和调试技巧,帮助读者有效地诊断和解决与智能指针,尤其是 weak_ptr 相关的错误。掌握这些方法可以提高调试效率,更深入地理解智能指针的行为。

    Appendix B1: 常用调试工具 (Common Debugging Tools)

    介绍在 C++ 智能指针调试中常用的工具,包括集成开发环境 (IDE) 的调试器、内存泄漏检测工具等。

    集成开发环境 (IDE) 调试器 (IDE Debugger)

    ▮▮▮▮IDE 调试器是开发过程中最常用且最强大的工具之一。现代 IDE,如 Visual Studio, CLion, Xcode 等,都提供了强大的 C++ 调试功能,可以帮助开发者深入了解程序运行时的状态,包括智能指针的内部状态。

    ▮▮▮▮ⓐ 断点 (Breakpoint) 与单步执行 (Step Execution): 在可能出现 weak_ptr 问题的代码行设置断点,通过单步执行,可以观察程序执行流程,查看变量的值,包括 weak_ptr 指向的对象地址、use_count (引用计数) 等信息。这有助于理解 weak_ptr 在程序运行过程中的状态变化。

    ▮▮▮▮ⓑ 变量监视 (Variable Watch): IDE 允许监视变量的值。可以将 weak_ptr 变量添加到监视列表,实时查看其状态,例如其是否 expired() (过期),以及通过 lock() 获取 shared_ptr 的结果。对于复杂的智能指针结构,变量监视尤其有用。

    ▮▮▮▮ⓒ 调用堆栈 (Call Stack): 当程序崩溃或出现异常时,查看调用堆栈可以帮助追溯问题发生的上下文。在智能指针的调试中,调用堆栈可以揭示智能指针的生命周期管理是否符合预期,例如,对象在何时被 delete,是否发生了意外的提前释放。

    内存泄漏检测工具 (Memory Leak Detection Tools)

    ▮▮▮▮内存泄漏是手动内存管理时代遗留的问题,智能指针在很大程度上避免了这类问题。然而,循环引用等情况仍然可能导致逻辑上的内存泄漏。内存泄漏检测工具可以帮助发现程序中未被释放的内存,从而定位潜在的智能指针使用问题。

    ▮▮▮▮ⓐ Valgrind (Linux/macOS): Valgrind 是一套强大的程序分析工具,其中的 Memcheck 工具可以检测内存泄漏、非法内存访问等问题。对于使用智能指针的 C++ 程序,Valgrind 可以有效地检测循环引用导致的内存泄漏,以及智能指针误用造成的悬挂指针等问题。使用 Valgrind 可以通过命令行运行程序,例如:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 valgrind --leak-check=full ./your_program

    Valgrind 会在程序结束后报告内存泄漏的详细信息,包括泄漏的内存块大小、分配位置的调用堆栈等。

    ▮▮▮▮ⓑ AddressSanitizer (ASan) (多种平台): AddressSanitizer 是一个快速的内存错误检测工具,可以检测 use-after-free, heap-buffer-overflow, stack-buffer-overflow, global-buffer-overflow 等多种内存错误。ASan 可以与编译器集成,通过编译选项 -fsanitize=address 启用。ASan 的优点是速度快,误报率低,适合在开发和测试阶段使用。

    ▮▮▮▮ⓒ Visual Studio 内存诊断工具 (Windows): Visual Studio 提供了内置的内存诊断工具,可以监控程序的内存使用情况,检测内存泄漏。通过内存快照比较、对象计数等功能,可以帮助开发者分析智能指针的内存管理行为,找出潜在的泄漏点。

    静态代码分析工具 (Static Code Analysis Tools)

    ▮▮▮▮静态代码分析工具可以在不实际运行程序的情况下,分析代码的潜在错误和缺陷。这些工具可以帮助在编码阶段发现智能指针的误用,例如潜在的循环引用、悬挂 weak_ptr 等。

    ▮▮▮▮ⓐ Clang Static Analyzer: Clang Static Analyzer 是一个强大的静态代码分析工具,可以检测 C++ 代码中的多种错误,包括内存管理错误、空指针解引用等。它可以集成到编译流程中,或者独立使用。

    ▮▮▮▮ⓑ Cppcheck: Cppcheck 是一个轻量级的静态代码分析工具,专注于检测 C++ 代码中的错误,包括内存泄漏、未初始化的变量、越界访问等。Cppcheck 易于使用,可以快速扫描代码并报告潜在问题。

    ▮▮▮▮ⓒ SonarQube: SonarQube 是一个代码质量管理平台,可以集成多种静态代码分析工具,提供代码质量的全面分析报告。SonarQube 可以帮助团队监控代码质量,及时发现和修复智能指针使用中的问题。

    Appendix B2: 智能指针调试技巧 (Debugging Techniques for Smart Pointers)

    介绍一些针对智能指针调试的实用技巧,帮助读者更有效地定位和解决问题。

    理解 weak_ptr 的状态 (Understand weak_ptr States)

    ▮▮▮▮weak_ptr 有两种主要状态:有效和过期。理解这两种状态是调试 weak_ptr 相关问题的关键。

    ▮▮▮▮ⓐ 有效状态 (Valid State): 当 weak_ptr 指向的对象仍然存活,即至少有一个 shared_ptr 指向该对象时,weak_ptr 处于有效状态。此时,可以通过 lock() 方法成功获取一个有效的 shared_ptr

    ▮▮▮▮ⓑ 过期状态 (Expired State): 当 weak_ptr 指向的对象已经被销毁,即没有任何 shared_ptr 指向该对象时,weak_ptr 处于过期状态。此时,调用 lock() 方法会返回一个空的 shared_ptr (nullptr)。

    ▮▮▮▮ⓒ 使用 expired() 检查状态: 在访问 weak_ptr 指向的对象之前,应该使用 expired() 方法检查 weak_ptr 是否过期。这可以避免访问悬挂指针的风险。例如:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 std::weak_ptr<MyObject> weakPtr;
    2 // ...
    3 if (!weakPtr.expired()) {
    4 std::shared_ptr<MyObject> sharedPtr = weakPtr.lock();
    5 if (sharedPtr) {
    6 // 安全地使用 sharedPtr 指向的对象
    7 sharedPtr->doSomething();
    8 }
    9 } else {
    10 // weakPtr 已过期,对象已被销毁
    11 }

    检查循环引用 (Check for Circular Dependencies)

    ▮▮▮▮循环引用是 shared_ptr 导致内存泄漏的常见原因,而 weak_ptr 的主要用途之一就是打破循环引用。调试时,需要仔细检查对象之间的关系,特别是当发现内存持续增长,但程序逻辑上应该释放内存时,需要考虑是否存在循环引用。

    ▮▮▮▮ⓐ 分析对象关系: 绘制对象关系图,分析对象之间的 shared_ptr 引用关系,特别是双向引用或多重引用,这些地方容易出现循环引用。

    ▮▮▮▮ⓑ 使用 weak_ptr 打破循环: 如果确认存在循环引用,应考虑将循环引用中的一个或多个 shared_ptr 替换为 weak_ptr。通常,将“从属”关系或“观察者”关系的 shared_ptr 改为 weak_ptr 可以有效打破循环。

    ▮▮▮▮ⓒ 内存快照对比: 使用内存诊断工具,在程序运行的不同阶段拍摄内存快照,比较内存分配情况。如果发现某些对象数量持续增加,但逻辑上应该保持稳定,可能存在循环引用导致的内存泄漏。

    理解 enable_shared_from_this 的作用 (Understand the Role of enable_shared_from_this)

    ▮▮▮▮enable_shared_from_this 是一个非常有用的基类,用于在类成员函数中安全地获取指向当前对象的 shared_ptr。当类需要将自身 shared_ptr 传递给其他对象时,必须使用 enable_shared_from_this,否则可能导致多次共享所有权管理,甚至程序崩溃。

    ▮▮▮▮ⓐ 正确使用 shared_from_this(): 继承自 enable_shared_from_this 的类,可以使用 shared_from_this() 方法获取指向当前对象的 shared_ptr。必须确保对象是由 shared_ptr 管理的,才能安全调用 shared_from_this(),否则会抛出 std::bad_weak_ptr 异常。

    ▮▮▮▮ⓑ 避免在构造函数中使用 shared_from_this(): 在构造函数中,对象的 shared_ptr 尚未完全创建,此时调用 shared_from_this() 是不安全的。应该在对象构造完成后,在成员函数或外部代码中调用 shared_from_this()

    日志 (Logging) 与断言 (Assertion)

    ▮▮▮▮在代码中添加适当的日志和断言,可以帮助在运行时监控智能指针的状态,及时发现问题。

    ▮▮▮▮ⓐ 日志输出智能指针状态: 在关键代码路径,例如 weak_ptr::lock() 之后,输出日志信息,记录 shared_ptr 是否为空,以及相关对象的生命周期状态。这有助于在程序运行时追踪智能指针的行为。

    ▮▮▮▮ⓑ 使用断言检查前提条件: 在使用 weak_ptr 之前,可以使用断言检查某些前提条件是否满足,例如 weak_ptr 不应该为空,或者在预期对象仍然存活的情况下,weak_ptr 不应该过期。例如:

    1.双击鼠标左键复制此行;2.单击复制所有代码。
                                    
                                        
    1 std::weak_ptr<MyObject> weakPtr;
    2 // ...
    3 assert(!weakPtr.expired()); // 断言 weakPtr 不应该过期
    4 std::shared_ptr<MyObject> sharedPtr = weakPtr.lock();
    5 assert(sharedPtr != nullptr); // 断言 lock() 应该成功
    6 // ... 使用 sharedPtr

    断言可以在开发和调试阶段快速发现违反程序预期的错误。

    代码审查 (Code Review)

    ▮▮▮▮代码审查是提高代码质量、减少 Bug 的有效手段。在智能指针的使用方面,代码审查可以帮助发现潜在的内存管理问题,例如循环引用、weak_ptr 的误用等。

    ▮▮▮▮ⓐ 关注智能指针的使用模式: 在代码审查时,特别关注智能指针的使用模式,例如 shared_ptr 的共享方式、weak_ptr 的使用场景、enable_shared_from_this 的应用等。

    ▮▮▮▮ⓑ 检查资源管理逻辑: 审查代码中的资源管理逻辑,确保所有资源都由智能指针正确管理,没有遗漏或错误。特别注意复杂的对象关系和生命周期管理,确保智能指针的使用符合预期。

    通过结合使用上述工具和技巧,开发者可以更有效地调试和解决 C++ 智能指针,特别是 weak_ptr 相关的问题,写出更健壮、更可靠的 C++ 代码。

    Appendix C: 术语表 (Glossary)

    Appendix C1: 术语表

    提供本书中使用的重要术语的中英文对照表,方便读者理解和查阅。

    智能指针 (Smart Pointer)
    ▮▮▮▮C++ 中用于自动管理内存的类模板,它模仿原始指针的行为,并在不再需要指向的对象时自动释放内存。常见的智能指针类型包括 unique_ptr (独占指针)、shared_ptr (共享指针) 和 weak_ptr (弱指针)。智能指针通过 RAII (Resource Acquisition Is Initialization) 原则来管理资源,避免内存泄漏和悬挂指针等问题。

    弱指针 (weak_ptr)
    ▮▮▮▮一种不控制所指向对象生命周期的智能指针。weak_ptr 必须从 shared_ptr 或另一个 weak_ptr 创建,它不增加对象的引用计数。weak_ptr 的主要用途是观察 shared_ptr 管理的对象,防止循环引用,并在对象仍然存活时安全地访问对象。可以通过 lock() 操作尝试获取一个 shared_ptr 来访问对象。

    共享指针 (shared_ptr)
    ▮▮▮▮一种实现共享所有权的智能指针。多个 shared_ptr 可以指向同一个对象,它们通过内部的引用计数来跟踪有多少个 shared_ptr 指向该对象。当最后一个指向对象的 shared_ptr 被销毁或重置时,所管理的对象才会被释放。shared_ptr 适用于多个所有者共享对象生命周期的场景。

    独占指针 (unique_ptr)
    ▮▮▮▮一种实现独占所有权的智能指针。一个 unique_ptr 独占地拥有它所指向的对象,不允许其他的智能指针共享所有权。unique_ptr 在销毁时会自动释放所管理的对象。unique_ptr 可以通过移动语义转移所有权,但不能复制。适用于需要明确所有权且所有权转移清晰的场景。

    原始指针 (Raw Pointer)
    ▮▮▮▮C++ 中最基本的指针类型,直接存储内存地址。原始指针需要手动使用 new 分配内存,并使用 delete 释放内存。手动管理原始指针容易出错,可能导致内存泄漏、悬挂指针等问题,因此在现代 C++ 中应尽可能使用智能指针来代替原始指针进行内存管理。

    内存管理 (Memory Management)
    ▮▮▮▮程序在运行时对计算机内存资源的分配和回收过程。有效的内存管理是保证程序稳定性和性能的关键。C++ 提供了手动内存管理(使用 newdelete)和自动内存管理(通过智能指针等机制)两种方式。

    资源管理 (Resource Management)
    ▮▮▮▮在程序中对各种系统资源(如内存、文件句柄、网络连接等)的获取、使用和释放进行管理的过程。资源管理的目标是确保资源在使用完毕后能够被正确释放,避免资源泄漏。RAII (Resource Acquisition Is Initialization) 是一种重要的资源管理技术。

    RAII (Resource Acquisition Is Initialization)
    ▮▮▮▮资源获取即初始化。一种 C++ 编程技术,它将资源的生命周期与对象的生命周期绑定。在对象构造时获取资源(初始化),在对象析构时释放资源。智能指针是 RAII 原则的典型应用,通过智能指针管理的对象在超出作用域时会自动析构,从而释放其管理的内存资源。

    引用计数 (Reference Counting)
    ▮▮▮▮一种用于跟踪对象被多少个指针或引用所指向的技术。在 shared_ptr 中,引用计数用于管理共享对象的生命周期。每当创建一个新的 shared_ptr 指向对象时,引用计数增加;当 shared_ptr 销毁或重置时,引用计数减少。当引用计数降为零时,表示对象不再被任何 shared_ptr 引用,此时对象可以被安全地释放。

    控制块 (Control Block)
    ▮▮▮▮shared_ptrweak_ptr 内部用于管理共享对象引用计数和管理信息的辅助数据结构。控制块通常动态分配在堆上,与被管理的对象关联。它包含对象的引用计数、弱引用计数、自定义删除器(如果存在)等信息。多个 shared_ptrweak_ptr 可以共享同一个控制块。

    循环引用 (Circular Dependency)
    ▮▮▮▮当两个或多个对象彼此持有 shared_ptr 智能指针,形成环状互相引用的关系时,就会发生循环引用。循环引用会导致引用计数永远无法降为零,从而造成内存泄漏,因为这些对象永远不会被释放。weak_ptr 可以用来打破循环引用。

    内存泄漏 (Memory Leak)
    ▮▮▮▮程序在动态分配内存后,由于某种原因未能正确释放已分配的内存,导致这些内存无法被再次使用,长期积累会耗尽系统内存资源,影响程序性能甚至导致程序崩溃。循环引用是导致内存泄漏的常见原因之一,手动内存管理不当也容易造成内存泄漏。

    悬挂指针 (Dangling Pointer)
    ▮▮▮▮指向已被释放或无效内存区域的指针。当程序尝试解引用悬挂指针时,会导致未定义行为,通常表现为程序崩溃或数据损坏。智能指针旨在避免悬挂指针问题。

    所有权 (Ownership)
    ▮▮▮▮在资源管理中,所有权指的是哪个对象或实体负责资源的生命周期管理,包括资源的分配和释放。智能指针通过所有权模型来自动管理内存。unique_ptr 实现独占所有权,shared_ptr 实现共享所有权,而 weak_ptr 不拥有所有权,只是观察者。

    过期 (Expired)
    ▮▮▮▮对于 weak_ptr 而言,当其关联的 shared_ptr 所管理的对象已经被销毁时,weak_ptr 就处于过期状态。可以通过 expired() 方法检查 weak_ptr 是否过期。

    有效 (Valid)
    ▮▮▮▮对于 weak_ptr 而言,当其关联的 shared_ptr 所管理的对象仍然存活时,weak_ptr 就处于有效状态。

    lock()
    ▮▮▮▮weak_ptr 类的一个成员函数,用于尝试从 weak_ptr 获取一个 shared_ptr。如果 weak_ptr 指向的对象仍然存活(未过期),lock() 会返回一个新的 shared_ptr,该 shared_ptr 会增加对象的引用计数,从而延长对象的生命周期。如果 weak_ptr 已经过期,lock() 会返回一个空的 shared_ptr (nullptr)。

    expired()
    ▮▮▮▮weak_ptr 类的一个成员函数,用于检查 weak_ptr 是否已过期。如果 weak_ptr 指向的对象已经被销毁,expired() 返回 true,否则返回 false

    reset()
    ▮▮▮▮weak_ptrshared_ptr 都具有的成员函数,用于重置智能指针。对于 weak_ptrreset() 会使其不再指向任何对象。对于 shared_ptrreset() 会减少其引用计数,并可能导致所管理的对象被释放(如果引用计数降为零)。

    use_count()
    ▮▮▮▮shared_ptrweak_ptr 都具有的成员函数,用于获取与智能指针共享同一个控制块的所有 shared_ptr 的数量(即引用计数)。注意,weak_ptruse_count() 方法返回的是关联的 shared_ptr 的引用计数,而不是 weak_ptr 本身的数量。weak_ptr 本身不影响引用计数。

    enable_shared_from_this
    ▮▮▮▮一个可以通过继承使用的 C++ 标准库类模板。当一个类继承自 enable_shared_from_this<T> 时,其成员函数可以安全地创建指向当前对象的 shared_ptr,通过调用 shared_from_this() 方法实现。这在需要从对象自身内部获取 shared_ptr 的场景中非常有用,例如在观察者模式或回调函数中。weak_ptrenable_shared_from_this 的实现中扮演重要角色。

    自定义删除器 (Custom Deleter)
    ▮▮▮▮在创建智能指针时,可以指定一个自定义的删除函数或函数对象,用于在智能指针销毁时释放所管理的对象。自定义删除器允许用户灵活地控制资源的释放方式,例如释放非 new 分配的内存,或执行其他清理操作。shared_ptrunique_ptr 都支持自定义删除器。

    线程安全 (Thread Safety)
    ▮▮▮▮指代码在多线程环境下运行时,能够正确地处理共享数据,避免出现数据竞争 (Data Race) 和其他并发问题。线程安全的代码可以在多个线程中并发执行而不会产生意外的结果。智能指针的线程安全级别需要根据具体操作来分析。

    并发 (Concurrency)
    ▮▮▮▮程序中多个独立的执行流(线程、进程等)在同一时间段内执行的能力。并发可以提高程序的响应性和资源利用率。多线程编程是实现并发的一种常见方式。

    同步 (Synchronization)
    ▮▮▮▮在并发编程中,为了保证共享数据的一致性和程序的正确性,需要使用同步机制来协调多个线程或进程的执行。同步机制包括互斥锁 (Mutex)、条件变量 (Condition Variable)、原子操作 (Atomic Operations) 等。在使用智能指针进行多线程编程时,需要考虑同步问题,确保线程安全。

    Appendix D: 参考文献 (References)

    附录D: 参考文献 (References)

    列出本书编写过程中参考的书籍、文章、网站等资源。

    参考文献 (References)

    为了确保本书内容的准确性、权威性和深度,并为读者提供进一步学习和研究的资源,本附录收录了编写本书过程中参考的重要文献资料。这些参考文献涵盖了 C++ 标准文档、权威书籍、技术文章、在线资源等,旨在为读者提供一个全面的学习参考列表,方便读者深入探索 C++ 智能指针和内存管理的相关知识。

    以下参考文献列表按照类型进行组织,包括 C++ 标准文档、书籍、文章和在线资源。

    C++ 标准文档 (C++ Standard Documents)

    ▮ C++ 官方标准是学习 C++ 最权威的资料,对于理解 weak_ptr 的定义、行为和规范至关重要。

    ▮▮▮▮ⓐ ISO/IEC 14882 - Programming Language C++:这是 C++ 语言的标准文档,包含了关于智能指针(包括 weak_ptr)的详细规范。读者可以通过 ISO 官方网站或各个国家标准组织获取。

    • ISO (International Organization for Standardization 国际标准化组织)
    • ANSI (American National Standards Institute 美国国家标准协会)

    书籍 (Books)

    ▮ 经典的 C++ 书籍通常会深入探讨智能指针,包括 weak_ptr 的原理和应用。以下列出一些具有代表性的书籍,它们对于理解 C++ 内存管理和智能指针至关重要。

    ▮▮▮▮ⓐ 《Effective C++》 (Effective C++) - Scott Meyers 著:

    • 本书深入探讨了 C++ 编程中的各种最佳实践,其中包含了关于智能指针的宝贵建议,虽然可能没有专门章节讨论 weak_ptr,但书中关于资源管理和智能指针的原则对于理解 weak_ptr 的使用场景非常有帮助。

    ▮▮▮▮ⓑ 《More Effective C++》 (More Effective C++) - Scott Meyers 著:

    • 作为《Effective C++》的续作,本书继续深入探讨了更多高级 C++ 主题,同样包含了关于智能指针的深入见解,可以帮助读者更全面地理解智能指针的使用。

    ▮▮▮▮ⓒ 《Effective Modern C++》 (Effective Modern C++) - Scott Meyers 著:

    • 本书专注于 C++11/14 标准的新特性,其中详细讲解了智能指针(unique_ptrshared_ptrweak_ptr)的使用,以及它们在现代 C++ 编程中的角色和最佳实践。对于希望学习现代 C++ 智能指针用法的读者,这本书是必读之作。

    ▮▮▮▮ⓓ 《C++ Primer》 (C++ Primer) - Stanley B. Lippman, Josée Lajoie, Barbara E. Moo 著:

    • 作为 C++ 学习的经典入门教材,本书全面而系统地介绍了 C++ 语言的各个方面,包括智能指针。书中对 weak_ptr 进行了清晰的解释,并通过示例展示了其基本用法和解决循环引用的作用。适合初学者系统学习 C++ 智能指针。

    ▮▮▮▮ⓔ 《The C++ Programming Language》 (C++ 编程语言) - Bjarne Stroustrup 著:

    • 由 C++ 语言的设计者本人撰写的权威著作,本书全面、深入地介绍了 C++ 语言的各个方面,包括智能指针的原理和实现。对于希望深入了解 C++ 语言和智能指针机制的读者,这本书是不可或缺的参考资料。

    ▮▮▮▮ⓕ 《深入理解现代C++ 智能指针》 - 陈硕 著:

    • 本书专注于现代 C++ 的智能指针,特别是 shared_ptrweak_ptr。作者结合实际案例和代码分析,深入剖析了智能指针的内部实现、使用技巧和最佳实践。对于中文读者来说,这是一本非常实用和深入的智能指针学习指南。

    文章 (Articles)

    ▮ 技术文章通常针对特定的问题或主题进行深入探讨,可以帮助读者从不同的角度理解 weak_ptr 的应用和细节。

    ▮▮▮▮ⓐ "Understanding and Using C++ Smart Pointers" (理解和使用 C++ 智能指针):

    • 这篇文章通常会概述 C++ 中的各种智能指针类型,包括 unique_ptrshared_ptrweak_ptr,并解释它们的使用场景和优势。可以在各种 C++ 相关的技术博客和网站上找到类似主题的文章。

    ▮▮▮▮ⓑ "Breaking Circular Dependencies with weak_ptr in C++" (使用 C++ weak_ptr 打破循环引用):

    • 这类文章会专注于讲解 weak_ptr 如何解决循环引用问题,通常会提供具体的代码示例和场景分析,帮助读者理解 weak_ptr 在解决这一经典问题中的作用。

    ▮▮▮▮ⓒ "Thread Safety of Smart Pointers in C++" (C++ 智能指针的线程安全性):

    • 这类文章会讨论智能指针在多线程环境下的线程安全性问题,特别是 weak_ptr 在并发访问时的注意事项,对于需要编写多线程 C++ 程序的开发者很有参考价值。

    在线资源 (Online Resources)

    ▮ 互联网上有很多关于 C++ 智能指针的优质资源,包括官方文档、教程、博客、问答社区等。

    ▮▮▮▮ⓐ cppreference.com

    • https://en.cppreference.com/w/cpp/memory/weak_ptr
    • cppreference.com 是一个非常全面的 C++ 参考网站,提供了关于 C++ 标准库的详细文档,包括 weak_ptr 的定义、成员函数、用法示例等。是学习 C++ 标准库的首选在线资源。

    ▮▮▮▮ⓑ cplusplus.com

    ▮▮▮▮ⓒ Stack Overflow

    ▮▮▮▮ⓓ 博客和教程 (Blogs and Tutorials)

    • 许多技术博客和在线教程也提供了关于 C++ 智能指针和 weak_ptr 的文章和教程。通过搜索引擎搜索 "C++ weak_ptr tutorial"、"C++ smart pointers explained" 等关键词,可以找到大量的学习资源。例如:
      ▮▮▮▮▮▮▮▮⚝ Learncpp.com: 提供了一系列关于 C++ 智能指针的教程,包括 weak_ptr 的详细解释和示例。
      ▮▮▮▮▮▮▮▮⚝ Baeldung on C++: 也提供了关于 C++ 智能指针的文章,涵盖了 weak_ptr 的使用场景和最佳实践。

    总结 (Summary)

    本参考文献列表旨在为读者提供一个全面而有益的学习资源,涵盖了从官方标准到实践指南的各个方面。读者可以根据自身的需求和兴趣,选择合适的资源进行深入学习,从而更全面、深入地理解和掌握 C++ weak_ptr 的原理、应用和最佳实践。通过结合本书的内容和这些参考文献,相信读者能够有效地提升 C++ 编程技能,写出更健壮、更高效的 C++ 代码。