命名空间
变体
操作

std::weak_ptr<T>::lock

来自 cppreference.com
< cpp‎ | memory‎ | weak ptr
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三方比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受限的未初始化内存算法
分配器
垃圾回收支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



 
 
std::shared_ptr<T> lock() const noexcept;
(自 C++11 起)

创建一个新的 std::shared_ptr,它共享对托管对象的拥有权。 如果没有托管对象,即 *this 为空,则返回的 shared_ptr 也为空。

实际上返回 expired() ? shared_ptr<T>() : shared_ptr<T>(*this),以原子方式执行。

内容

[编辑] 参数

(无)

[编辑] 返回值

如果 std::weak_ptr::expired 返回 false,则返回一个共享被拥有对象所有权的 shared_ptr。 否则返回类型为 T 的默认构造的 shared_ptr

[编辑] 备注

此函数和 std::shared_ptr 的构造函数都可用于获取对 std::weak_ptr 所引用的托管对象的临时所有权。 不同之处在于,std::shared_ptr 的构造函数在它的 std::weak_ptr 参数为空时抛出异常,而 std::weak_ptr<T>::lock() 构造一个空的 std::shared_ptr<T>

[编辑] 示例

#include <iostream>
#include <memory>
 
void observe(std::weak_ptr<int> weak)
{
    if (auto p = weak.lock())
        std::cout << "\tobserve() is able to lock weak_ptr<>, value=" << *p << '\n';
    else
        std::cout << "\tobserve() is unable to lock weak_ptr<>\n";
}
 
int main()
{
    std::weak_ptr<int> weak;
    std::cout << "weak_ptr<> is not yet initialized\n";
    observe(weak);
 
    {
        auto shared = std::make_shared<int>(42);
        weak = shared;
        std::cout << "weak_ptr<> is initialized with shared_ptr\n";
        observe(weak);
    }
 
    std::cout << "shared_ptr<> has been destructed due to scope exit\n";
    observe(weak);
}

输出

weak_ptr<> is not yet initialized
        observe() is unable to lock weak_ptr<>
weak_ptr<> is initialized with shared_ptr
        observe() is able to lock weak_ptr<>, value=42
shared_ptr<> has been destructed due to scope exit
        observe() is unable to lock weak_ptr<>

[编辑] 缺陷报告

以下行为更改缺陷报告已追溯应用于以前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 2316 C++11 lock() 不需要是原子的,但需要是 noexcept,这会导致矛盾 指定为原子

[编辑] 另请参见

检查引用的对象是否已被删除
(公共成员函数) [编辑]