operator== (std::common_iterator)
|
template
<
class
I2,
std::
sentinel_for
<
I
>
S2
>
requires
std::
sentinel_for
<
S, I2
>
|
(1) | (C++20 起) |
|
template
<
class
I2,
std::
sentinel_for
<
I
>
S2
>
requires
std::
sentinel_for
<
S, I2
>
&&
std::
equality_comparable_with
<
I, I2
>
|
(2) | (C++20 起) |
比较底层
std::variant
成员对象
var
所持有的迭代器和/或哨兵。两个不可比较的迭代器或两个哨兵被视为相等。
如果 x 或 y 处于无效状态,即当 x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) 等于 true 时, 行为是未定义的。
设
i
为
x.
var
.
index
(
)
且
j
为
y.
var
.
index
(
)
。
!=
运算符由
operator==
合成而来。
这些函数模板对普通的 非限定查找 或 限定查找 不可见,仅当 std::common_iterator<I> 作为参数的关联类时,才能通过 实参依赖查找 找到它们。
目录 |
参数
| x, y | - | 用于比较的迭代器适配器 |
返回值
true 如果底层迭代器和/或哨兵相等。
示例
#include <cassert> #include <iterator> int main() { int a[]{0, 1, 2, 3}; using CI = std::common_iterator< std::counted_iterator<int*>, std::default_sentinel_t >; CI i1{std::counted_iterator{a + 0, 2}}; CI i2{std::counted_iterator{a + 1, 2}}; CI i3{std::counted_iterator{a + 0, 3}}; CI i4{std::counted_iterator{a + 0, 0}}; CI s1{std::default_sentinel}; CI s2{std::default_sentinel}; assert((i1 == i2) == true); assert((i1 == i3) == false); assert((i2 == i3) == false); assert((s1 == s2) == true); assert((i1 == s1) == false); assert((i4 == s1) == true); }
缺陷报告
下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
| 缺陷报告 | 适用范围 | 发布时行为 | 正确行为 |
|---|---|---|---|
| LWG 3574 | C++20 |
variant
已完全支持 constexpr (P2231R1) 但
common_iterator
未支持
|
同时设为 constexpr |
参见
|
(C++20)
|
计算两个迭代器适配器之间的距离
(函数模板) |