operator==,!=,<,<=,>,>=,<=>(std::pair)

工具库

语言支持
类型支持（基本类型、 RTTI 、类型特征）
库功能特性测试宏 (C++20)
动态内存管理
程序工具
错误处理
协程支持 (C++20)
变参数函数
launder (C++17)
initializer_list (C++11)
source_location (C++20)
三路比较 (C++20)
three_way_comparablethree_way_comparable_with (C++20)(C++20)
strong_ordering (C++20)
weak_ordering (C++20)
partial_ordering (C++20)
common_comparison_category (C++20)
compare_three_way_result (C++20)
compare_three_way (C++20)
strong_order (C++20)
weak_order (C++20)
partial_order (C++20)
compare_strong_order_fallback (C++20)
compare_weak_order_fallback (C++20)
compare_partial_order_fallback (C++20)
is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

通用工具

日期和时间
函数对象
bitset

格式化库 (C++20)
hash (C++11)
integer_sequence (C++14)

关系运算符 (C++20 中弃用)

rel_ops::operator!=rel_ops::operator>

rel_ops::operator<=rel_ops::operator>=

整数比较函数

cmp_equalcmp_lesscmp_less_than

(C++20)(C++20)(C++20)

cmp_not_equalcmp_greatercmp_greater_than

(C++20)(C++20)(C++20)

in_range

(C++20)

swap 与类型运算

swap
ranges::swap (C++20)
exchange (C++14)
declval (C++11)

forward (C++11)
move (C++11)
move_if_noexcept (C++11)
as_const (C++17)
to_underlying (C++23)

常用词汇类型

pair
tuple (C++11)
optional (C++17)
any (C++17)
variant (C++17)

tuple_size (C++11)
tuple_element (C++11)
apply (C++17)
make_from_tuple (C++17)

初等字符串转换

to_chars (C++17)
from_chars (C++17)

chars_format

(C++17)

栈踪

stacktrace_entry

(C++23)

basic_stacktrace

(C++23)

定义于头文件 `<utility>`
	(1)
template< class T1, class T2 > bool operator==( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );			(C++14 前)
template< class T1, class T2 > constexpr bool operator==( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );			(C++14 起)
		(2)
template< class T1, class T2 > bool operator!=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );				(C++14 前)
template< class T1, class T2 > constexpr bool operator!=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );				(C++14 起) (C++20 前)
			(3)
template< class T1, class T2 > bool operator<( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );					(C++14 前)
template< class T1, class T2 > constexpr bool operator<( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );					(C++14 起) (C++20 前)
				(4)
template< class T1, class T2 > bool operator<=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );						(C++14 前)
template< class T1, class T2 > constexpr bool operator<=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );						(C++14 起) (C++20 前)
					(5)
template< class T1, class T2 > bool operator>( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );							(C++14 前)
template< class T1, class T2 > constexpr bool operator>( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );							(C++14 起) (C++20 前)
						(6)
template< class T1, class T2 > bool operator>=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );								(C++14 前)
template< class T1, class T2 > constexpr bool operator>=( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );								(C++14 起) (C++20 前)
template< class T1, class T2 > constexpr /* see below */ operator<=>( const std::pair<T1,T2>& lhs, const std::pair<T1,T2>& rhs );							(7)	(C++20 起)

1-2) 测试 lhs 和 rhs 的两个元素是否均相等，即比较 lhs.first 和 rhs.first 及 lhs.second 和 rhs.second

3-6) 用 operator< 按字典序比较 lhs 和 rhs ，即比较首元素，然后仅若它们等价，再比较第二元素。

7) 用合成三路比较按字典序比较 lhs 和 rhs ，即比较首元素，然后仅若它们等价，再比较第二元素。
返回类型为 T1 与 T2 上的合成三路比较类型的结果类型的共用比较类别类型。

<、 <=、 >、 >= 及 != 运算符分别从 operator<=> 与 operator== 合成。

(C++20 起)

合成三路比较

给定对象类型 T ，分别作为左操作数和右操作数的二个 const T 左值 lhs 与 rhs ，合成三路比较定义为：

若满足 std::three_way_comparable_with<T, T> ，则等价于 lhs <=> rhs;
否则，若以 operator< 比较二个 const T 左值为良构且结果类型满足 boolean-testable ，则等价于

lhs < rhs ? std::weak_ordering::less :
rhs < lhs ? std::weak_ordering::greater :
            std::weak_ordering::equivalent

否则不定义合成三路比较，这使得 operator<=> 不参与重载决议。

若 three_way_comparable_with 或 boolean-testable 被满足但未被实现，则 operator<=> 的行为未定义。

(C++20 起)

参数

lhs, rhs

-

要比较的 pair

返回值

1) 若 lhs.first == rhs.first 且 lhs.second == rhs.second 则为 true ，否则为 false

2) !(lhs == rhs)

3) 若 lhs.first<rhs.first 则返回 true 。否则，若 rhs.first<lhs.first 则返回 false 。否则，若 lhs.second<rhs.second 则返回 true 。否则返回 false 。

4) !(rhs < lhs)

5) rhs < lhs

6) !(lhs < rhs)

7) 若 synth_three_way(lhs.first, rhs.first) 不等于 0 则为它，否则为 synth_three_way(lhs.second, rhs.second) ，其中 synth_three_way 是仅用于阐释的进行合成三路比较的函数对象。

示例

因为 operator< 为 pair 定义，故 pair 的容器能排序。

运行此代码

#include <iostream>
#include <utility>
#include <vector>
#include <algorithm>
#include <string>
 
int main()
{
    std::vector<std::pair<int, std::string>> v = { {2, "baz"},
                                                   {2, "bar"},
                                                   {1, "foo"} };
    std::sort(v.begin(), v.end());
 
    for(auto p: v) {
        std::cout << "(" << p.first << "," << p.second << ")\n";
    }
}

输出：

(1,foo)
(2,bar)
(2,baz)

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
技术规范

成员函数
pair::pair
pair::operator=
pair::swap
非成员函数
make_pair
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
std::swap
get (C++11)
推导指引(C++17)
辅助类
tuple_size (C++11)
tuple_element (C++11)

operator==,!=,<,<=,>,>=,<=>(std::pair)

合成三路比较

参数

返回值

示例

导航