operator==,<=>(std::inplace_vector)

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

容器库

序列

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

关联

set

multiset

map

multimap

无序关联

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表

非成员函数表

 

std::inplace_vector

成员类型
成员函数
inplace_vector::inplace_vector inplace_vector::~inplace_vector    inplace_vector::operator= inplace_vector::assign inplace_vector::assign_range 大小和容量 inplace_vector::empty inplace_vector::size inplace_vector::max_size inplace_vector::capacity inplace_vector::resize inplace_vector::reserve inplace_vector::shrink_to_fit 迭代器 inplace_vector::begininplace_vector::cbegin inplace_vector::endinplace_vector::cend inplace_vector::rbegininplace_vector::crbegin inplace_vector::rendinplace_vector::crend	元素访问 inplace_vector::at inplace_vector::operator[] inplace_vector::front inplace_vector::back inplace_vector::data 修改器 inplace_vector::clear inplace_vector::erase inplace_vector::swap inplace_vector::insert inplace_vector::insert_range inplace_vector::emplace inplace_vector::emplace_back inplace_vector::try_emplace_back inplace_vector::unchecked_emplace_back inplace_vector::push_back inplace_vector::try_push_back inplace_vector::unchecked_push_back inplace_vector::pop_back inplace_vector::append_range inplace_vector::try_append_range
非成员函数
erase(std::inplace_vector)erase_if(std::inplace_vector) swap(std::inplace_vector)	operator==operator<=>

 

constexpr friend bool operator==( const std::inplace_vector<T, N>& lhs,                                   const std::inplace_vector<T, N>& rhs );	(1)	(since C++26)
constexpr friend synth-three-way-result<T>     operator<=>( const std::inplace_vector<T, N>& lhs,                  const std::inplace_vector<T, N>& rhs );	(2)	(since C++26)

比较两个 std::inplace_vector 的内容。

1) 检查 lhs 和 rhs 的内容是否相等，即它们是否具有相同数量的元素，并且 lhs 中的每个元素与 rhs 中相同位置的元素比较相等。

2) 按照字典顺序比较 lhs 和 rhs 的内容。 比较的执行方式如同调用
std::lexicographical_compare_three_way(lhs.begin(), lhs.end(),
                                       rhs.begin(), rhs.end(), synth-three-way);.

返回类型是 synth-three-way 的返回类型 (即 synth-three-way-result <T>)。

必须满足以下条件之一

• T 模型 three_way_comparable。
• 为 T 类型（可能带有 const 限定）的值定义了 <，并且 < 是全序关系。

   否则，行为未定义。

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

参数

lhs, rhs	-	std::inplace_vector，要比较其内容
- T 必须满足 EqualityComparable 的要求才能使用重载 (1)。

返回值

1) 如果 std::inplace_vector 的内容相等，则为 true，否则为 false。

2) 如果存在不相等的元素对，则为 lhs 和 rhs 中第一对不相等元素的相对顺序，否则为 lhs.size() <=> rhs.size()。

复杂度

1) 如果 lhs 和 rhs 的大小不同，则为常数时间，否则与 std::inplace_vector 的大小呈线性关系。

2) 与 std::inplace_vector 的大小呈线性关系。

注解

关系运算符根据 synth-three-way 定义，后者尽可能使用 operator<=>，否则使用 operator<。

值得注意的是，如果元素本身不提供 operator<=>，但可以隐式转换为三路可比较类型，则将使用该转换而不是 operator<。

示例

运行此代码

#include <inplace_vector>
 
int main()
{
    constexpr std::inplace_vector<int, 4>
        a{1, 2, 3},
        b{1, 2, 3},
        c{7, 8, 9, 10};
 
    static_assert
    (""
        "Compare equal containers:" &&
        (a != b) == false &&
        (a == b) == true &&
        (a < b) == false &&
        (a <= b) == true &&
        (a > b) == false &&
        (a >= b) == true &&
        (a <=> b) >= 0 &&
        (a <=> b) <= 0 &&
        (a <=> b) == 0 &&
 
        "Compare non equal containers:" &&
        (a != c) == true &&
        (a == c) == false &&
        (a < c) == true &&
        (a <= c) == true &&
        (a > c) == false &&
        (a >= c) == false &&
        (a <=> c) < 0 &&
        (a <=> c) != 0 &&
        (a <=> c) <= 0 &&
    "");
}