operator==(std::common_iterator)

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 );

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 );

Сравнивает итераторы и/или стоп-значения, хранимые в базовых объектах-членах 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> является связанным классом аргументов.

Параметры

Значение возврата

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++.

См. также