命名空间
变体
操作

std::owner_less

来自 cppreference.cn
< cpp‎ | memory
 
 
内存管理库
(仅为解释目的*)
未初始化内存算法
(C++17)
(C++17)
(C++17)
受约束的未初始化
内存算法
C 库

分配器
内存资源
垃圾回收支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
未初始化存储
(直到 C++20*)
(直到 C++20*)
显式生命周期管理
 
定义于头文件 <memory>
(1)
template< class T >
struct owner_less; /* undefined */
(since C++11)
(until C++17)
template< class T = void >
struct owner_less; /* undefined */
(since C++17)
template< class T >
struct owner_less<std::shared_ptr<T>>;
(2) (since C++11)
template< class T >
struct owner_less<std::weak_ptr<T>>;
(3) (since C++11)
template<>
struct owner_less<void>;
(4) (since C++17)

此函数对象提供基于所有权(而非基于值)的 std::weak_ptrstd::shared_ptr 的混合类型排序。此顺序使得只有当两个智能指针都为空或它们共享所有权时,它们才被视为等价,即使通过 get() 获取的原始指针的值不同(例如,因为它们指向同一对象内不同的子对象)。

1) 不为 std::shared_ptrstd::weak_ptr 以外的类型提供基于所有权的混合类型排序。
2) std::shared_ptr 的基于所有权的混合类型排序。
当使用 std::shared_ptr 作为键构建关联容器时,这是首选的比较谓词,即 std::map<std::shared_ptr<T>, U, std::owner_less<std::shared_ptr<T>>>
3) std::weak_ptr 的基于所有权的混合类型排序。
当使用 std::weak_ptr 作为键构建关联容器时,这是首选的比较谓词,即 std::map<std::weak_ptr<T>, U, std::owner_less<std::weak_ptr<T>>>
4) void 特化从参数推导参数类型。

默认的 operator< 未为弱指针定义,并且可能错误地认为指向同一对象的两个共享指针不等价(参见 std::shared_ptr::owner_before)。

目录

特化

当未指定 T 时,标准库提供了 std::owner_less 的特化。在这种情况下,参数类型从参数推导(每个参数仍然必须是 std::shared_ptrstd::weak_ptr)。

函数对象,提供共享和弱指针的混合类型、基于所有权的排序,而与被指向对象的类型无关
(类模板特化) [编辑]
(since C++17)


嵌套类型

嵌套类型 定义
result_type (C++17 中已弃用) (2,3) bool
first_argument_type (C++17 中已弃用) (2) std::shared_ptr<T>
(3) std::weak_ptr<T>
second_argument_type (C++17 中已弃用) (2) std::shared_ptr<T>
(3) std::weak_ptr<T>
(直到 C++20)

[编辑] 成员函数

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

std::owner_less::operator()

仅限特化 (2) 的成员
bool operator()( const std::shared_ptr<T>& lhs,
                 const std::shared_ptr<T>& rhs ) const noexcept;
(since C++11)
仅限特化 (3) 的成员
bool operator()( const std::weak_ptr<T>& lhs,
                 const std::weak_ptr<T>& rhs ) const noexcept;
(since C++11)
两个模板特化的成员
bool operator()( const std::shared_ptr<T>& lhs,
                 const std::weak_ptr<T>& rhs ) const noexcept;
(since C++11)
bool operator()( const std::weak_ptr<T>& lhs,
                 const std::shared_ptr<T>& rhs ) const noexcept;
(since C++11)

使用基于所有权的语义比较 lhsrhs。有效地调用 lhs.owner_before(rhs)

排序是严格弱序关系。

lhsrhs 只有在都为空或共享所有权时才等价。

参数

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

返回值

如果根据基于所有权的排序,lhs 小于 rhs,则返回 true,否则返回 false

[编辑] 缺陷报告

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

DR 应用于 已发布行为 正确行为
LWG 2873 C++11 operator() 未被要求为 noexcept 要求为 noexcept

[编辑] 参见

提供共享指针的基于所有权的排序
(std::shared_ptr<T> 的公共成员函数) [编辑]
提供弱指针的基于所有权的排序
(std::weak_ptr<T> 的公共成员函数) [编辑]