命名空间
变体
操作

std::owner_equal

来自 cppreference.com
< cpp‎ | memory
 
 
实用程序库
语言支持
类型支持 (基本类型,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)



 
定义在头文件 <memory>
struct owner_equal;
(自 C++26 起)

此函数对象提供基于所有者(与基于值相反)的混合类型相等比较,用于 std::weak_ptrstd::shared_ptr。比较方式使得两个智能指针仅当它们都为空或它们共享所有权时才视为等效,即使通过 get() 获得的原始指针的值不同(例如,因为它们指向同一个对象内的不同子对象)。

1) 基于所有者的混合类型相等比较不适用于 std::shared_ptrstd::weak_ptr 以外的类型。
2) std::shared_ptrstd::weak_ptr 的基于所有者的混合类型相等比较。
当构建使用 std::shared_ptrstd::weak_ptr 作为键的无序关联容器以及 std::owner_hash 时,它是首选的比较谓词,也就是说,std::unordered_map<std::shared_ptr<T>, U, std::owner_hash, std::owner_equal>std::unordered_map<std::weak_ptr<T>, U, std::owner_hash, std::owner_equal>.
3) std::owner_equal 从参数推断参数类型。

内容

[编辑] 嵌套类型

嵌套类型 定义
is_transparent 未指定

[编辑] 成员函数

operator()
使用基于所有者的语义比较其参数
(函数)

std::owner_equal::operator()

template< class T, class U >

bool operator()( const std::shared_ptr<T>& lhs,

                 const std::shared_ptr<U>& rhs ) const noexcept;
(自 C++26 起)
template< class T, class U >

bool operator()( const std::shared_ptr<T>& lhs,

                 const std::weak_ptr<U>& rhs ) const noexcept;
(自 C++26 起)
template< class T, class U >

bool operator()( const std::weak_ptr<T>& lhs,

                 const std::shared_ptr<U>& rhs ) const noexcept;
(自 C++26 起)
template< class T, class U >

bool operator()( const std::weak_ptr<T>& lhs,

                 const std::weak_ptr<U>& rhs ) const noexcept;
(自 C++26 起)

使用基于所有者的语义比较 lhsrhs。实际上调用 lhs.owner_equal(rhs).

相等比较是一种等价关系。

lhsrhs 当且仅当它们都为空或共享所有权时才等价。

参数

lhs, rhs - 要比较的共享所有权指针

返回值

true 如果 lhsrhs 都为空或根据基于所有者的相等比较共享所有权,否则为 false

[编辑] 备注

功能测试 Std 功能
__cpp_lib_smart_ptr_owner_equality 202306L (C++26) 启用在 无序关联容器 中使用 std::shared_ptrstd::weak_ptr 作为键

[编辑] 另请参阅

提供共享指针的基于所有者的相等比较
(std::shared_ptr<T> 的公有成员函数) [编辑]
提供弱指针的基于所有者的相等比较
(std::weak_ptr<T> 的公有成员函数) [编辑]