Namensräume
Varianten
Aktionen

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

Von cppreference.com
 
 
Iterator-Bibliothek
Iterator-Konzepte
Iterator-Primitive
Algorithmus-Konzepte und Hilfsprogramme
Indirekte aufrufbare Konzepte
Gemeinsame Algorithmus-Anforderungen
(C++20)
(C++20)
(C++20)
Dienstprogramme
(C++20)
Iterator-Adapter
Bereichszugriff
(C++11)(C++14)
(C++14)(C++14)  
(C++11)(C++14)
(C++14)(C++14)  
(C++17)(C++20)
(C++17)
(C++17)
 
 
Definiert in Header <iterator>
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(1) (constexpr seit C++17)
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(2) (constexpr seit C++17)
(bis C++20)
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(3) (constexpr seit C++17)
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(4) (constexpr seit C++17)
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(5) (constexpr seit C++17)
template< class Iter1, class Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(6) (constexpr seit C++17)
template< class Iter1, std::three_way_comparable_with<Iter1> Iter2 >

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

                 const std::move_iterator<Iter2>& rhs );
(7) (seit C++20)

Vergleicht die zugrundeliegenden Iteratoren von lhs und rhs.

1) Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn lhs.base() == rhs.base() wohlgeformt und konvertierbar zu bool ist.
3-6) Diese Überladungen nehmen an der Überladungsauflösung nur teil, wenn lhs.base() < rhs.base() wohlgeformt und konvertierbar zu bool ist.

Der Operator != wird aus operator== synthetisiert.

(seit C++20)

Inhalt

[bearbeiten] Parameter

lhs, rhs - Iterator-Adapter zum Vergleichen

[bearbeiten] Rückgabewert

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

[bearbeiten] Beispiel

#include <cassert>
#include <iterator>
 
int main()
{
    int a[]{9, 8, 7, 6};
    //            │  └───── x, y
    //            └──────── z
 
    // “x” and “y” are equal, but “x” is greater than “z”
    std::move_iterator<int*>
        x{std::end(a) - 1},
        y{std::end(a) - 1},
        z{std::end(a) - 2};
 
    // two-way comparisons
    assert(  x == y );
    assert(!(x != y));
    assert(!(x <  y));
    assert(  x <= y );
    assert(!(x == z));
    assert(  x != z );
    assert(!(x <  z));
    assert(!(x <= z));
 
    // three-way comparisons
    assert(  x <=> y == 0 );
    assert(!(x <=> y <  0));
    assert(!(x <=> y >  0));
    assert(!(x <=> z == 0));
    assert(!(x <=> z <  0));
    assert(  x <=> z >  0 );
}

[bearbeiten] Siehe auch

vergleicht den zugrundeliegenden Iterator und das zugrundeliegende Sentinel
(Funktionstemplate) [edit]