Namespaces
Variants

operator== (std::common_iterator)

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
template < class I2, std:: sentinel_for < I > S2 >

requires std:: sentinel_for < S, I2 >
friend constexpr bool operator == ( const common_iterator & x,

const std:: common_iterator < I2, S2 > & y ) ;
(1) (C++20 起)
template < class I2, std:: sentinel_for < I > S2 >

requires std:: sentinel_for < S, I2 > && std:: equality_comparable_with < I, I2 >
friend constexpr bool operator == ( const common_iterator & x,

const std:: common_iterator < I2, S2 > & y ) ;
(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 ( )

1) i == j (即 x y 均持有迭代器或均持有哨位),则返回 true ;否则返回 std :: get < i > ( x. var ) == std :: get < j > ( y. var )
2) 如果 i == 1 && j == 1 (即 x y 均持有哨兵值),则返回 true ,否则返回 std :: get < i > ( x. var ) == std :: get < j > ( y. var )

!= 运算符由 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)
计算两个迭代器适配器之间的距离
(函数模板)