Namespaces
Variants

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

From cppreference.net
C++
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)
std::reverse_iterator
(Примечание: В данном фрагменте HTML отсутствует текстовое содержимое для перевода - присутствуют только HTML-теги и атрибуты, которые согласно инструкциям не подлежат переводу)
Определено в заголовочном файле <iterator>
template < class Iter1, class Iter2 >

bool operator == ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(1) (constexpr начиная с C++17)
template < class Iter1, class Iter2 >

bool operator ! = ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(2) (constexpr начиная с C++17)
template < class Iter1, class Iter2 >

bool operator < ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(3) (constexpr начиная с C++17)
template < class Iter1, class Iter2 >

bool operator <= ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(4) (constexpr начиная с C++17)
template < class Iter1, class Iter2 >

bool operator > ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(5) (constexpr начиная с C++17)
template < class Iter1, class Iter2 >

bool operator >= ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(6) (constexpr начиная с C++17)
template < class Iter1, std:: three_way_comparable_with < Iter1 > Iter2 >

constexpr std:: compare_three_way_result_t < Iter1, Iter2 >
operator <=> ( const std:: reverse_iterator < Iter1 > & lhs,

const std:: reverse_iterator < Iter2 > & rhs ) ;
(7) (начиная с C++20)

Сравнивает базовые итераторы lhs и rhs .

  • Результаты сравнений на равенство сохраняются (т.е. равные базовые итераторы подразумевают равные обратные итераторы).
  • Результаты реляционных сравнений инвертируются (т.е. больший базовый итератор подразумевает меньший обратный итератор).
1) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) == rhs. base ( ) является корректно сформированным и преобразуемым в bool .
2) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) ! = rhs. base ( ) является корректно сформированным и преобразуемым в bool .
3) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) > rhs. base ( ) является корректно сформированным и преобразуемым в bool .
4) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) >= rhs. base ( ) является корректно сформированным и преобразуемым в bool .
5) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) < rhs. base ( ) является корректно сформированным и преобразуемым в bool .
6) Эта перегрузка участвует в разрешении перегрузки только если lhs. base ( ) <= rhs. base ( ) является корректно сформированным и преобразуемым в bool .
(начиная с C++20)


Содержание

Параметры

lhs, rhs - адаптеры итераторов для сравнения

Возвращаемое значение

1) lhs. base ( ) == rhs. base ( )
2) lhs. base ( ) ! = rhs. base ( )
3) lhs. base ( ) > rhs. base ( )
4) lhs. base ( ) >= rhs. base ( )
5) lhs. base ( ) < rhs. base ( )
6) lhs. base ( ) <= rhs. base ( )
7) rhs. base ( ) <=> lhs. base ( )

Примечания

operator <=> возвращает rhs. base ( ) <=> lhs. base ( ) вместо lhs. base ( ) <=> rhs. base ( ) поскольку это реверсивный итератор.

Пример

Запустить этот код 
#include <cassert>
#include <iterator>
int main()
{
    int a[]{0, 1, 2, 3};
    //            ↑  └───── x, y
    //            └──────── z
    // «x» и «y» равны, но «x» меньше «z» (в обратном порядке)
    std::reverse_iterator<int*>
        x{std::rend(a) - std::size(a)},
        y{std::rend(a) - std::size(a)},
        z{std::rbegin(a) + 1};
    // двусторонние сравнения
    assert(  x == y );
    assert(!(x != y));
    assert(!(x <  y));
    assert(  x <= y );
    assert(!(x == z));
    assert(  x != z );
    assert(  x <  z );
    assert(  x <= z );
    // трёхсторонние сравнения
    assert(  x <=> y == 0 );
    assert(!(x <=> y <  0));
    assert(!(x <=> y >  0));
    assert(!(x <=> z == 0));
    assert(  x <=> z <  0 );
    assert(!(x <=> z >  0));
}

Отчеты о дефектах

Следующие отчеты об изменениях в поведении, содержащие описания дефектов, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
LWG 280 C++98 heterogeneous assignment was not allowed allowed
Перевод на русский язык (с сохранением HTML-разметки и C++ терминов):
DR Применяется к Поведение в опубликованной версии Корректное поведение
LWG 280 C++98 heterogeneous assignment не допускалось допускается