std::owner_equal

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

内存管理库

分配器 allocator allocator_traits (C++11) allocation_result (C++23) scoped_allocator_adaptor (C++11) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) pmr::polymorphic_allocator (C++17) uninitialized_construct_using_allocator (C++20) 内存资源 pmr::memory_resource (C++17) pmr::get_default_resource (C++17)     pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::pool_options (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17)     pmr::monotonic_buffer_resource (C++17) 显式生存期管理 start_lifetime_as (C++23) start_lifetime_as_array (C++23) 用于复合类设计的类型 indirect (C++26) polymorphic (C++26) 杂项 pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) is_sufficiently_aligned (C++26) C 库 malloc      free calloc realloc aligned_alloc (C++17) free_sized (C++26) free_aligned_sized (C++26) memalignment (C++26) 未初始化存储 (C++20 前*) raw_storage_iterator get_temporary_buffer return_temporary_buffer 垃圾收集器支持 (C++23 前) declare_reachable (C++11) declare_no_pointers (C++11) pointer_safety (C++11) undeclare_reachable (C++11) undeclare_no_pointers (C++11) get_pointer_safety (C++11)

<memory> 专门算法 低层内存管理 operator newoperator new[] operator deleteoperator delete[] nothrow nothrow_t new_handler set_new_handler get_new_handler (C++11) bad_alloc bad_array_new_length (C++11) align_val_t (C++17) destroying_delete_t (C++20) launder (C++17) 智能指针 unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (C++17 前*) owner_less (C++11) owner_less<void> (C++17) owner_hash (C++26) owner_equal (C++26) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23)

 

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

这个函数对象为 std::shared_ptr 和 std::weak_ptr 提供了基于所有者（而非基于值）的混合类型相等比较。这种比较中，仅当两个智能指针都为空或者共享所有权时比较为等价，即使通过 get() 获取的原生指针值不同（比如由于它们指向同一对象中的不同子对象）也是如此。

这是以 std::shared_ptr 和 std::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>。

嵌套类型

嵌套类型	定义
is_transparent	未指定

成员函数

operator()

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

std::owner_equal::operator()

template< class T, class U > constexpr bool operator()( const std::shared_ptr<T>& lhs, const std::shared_ptr<U>& rhs ) const noexcept;	(1)	(C++26 起)
template< class T, class U > constexpr bool operator()( const std::shared_ptr<T>& lhs, const std::weak_ptr<U>& rhs ) const noexcept;	(2)	(C++26 起)
template< class T, class U > constexpr bool operator()( const std::weak_ptr<T>& lhs, const std::shared_ptr<U>& rhs ) const noexcept;	(3)	(C++26 起)
template< class T, class U > constexpr bool operator()( const std::weak_ptr<T>& lhs, const std::weak_ptr<U>& rhs ) const noexcept;	(4)	(C++26 起)

使用基于所有者的语义比较 lhs 和 rhs。相当于调用 lhs.owner_equal(rhs)。

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

仅当 lhs 和 rhs 都为空或共享所有权时它们等价。

参数

lhs, rhs

-

要比较的共享所有权指针

返回值

当 lhs 和 rhs 都为空，或由基于所有者的相等比较确定为共享所有权时返回 true，否则返回 false。

注解

功能特性测试宏	值	标准	功能特性
__cpp_lib_smart_ptr_owner_equality	202306L	(C++26)	使 std::shared_ptr 和 std::weak_ptr 可用作无序关联容器中的键
__cpp_lib_constexpr_memory	202506L	(C++26)	constexpr std::owner_equal

参阅

owner_equal (C++26)	提供基于所有者的共享指针相等比较 (std::shared_ptr<T> 的公开成员函数)
owner_equal (C++26)	提供弱指针的基于所有者的相等比较 (std::weak_ptr<T> 的公开成员函数)