Namespaces
Variants

operator== (std::common_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::common_iterator
template < class I2, std:: sentinel_for < I > S2 >

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

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

erfordert 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) (seit C++20)

Vergleicht die Iteratoren und/oder Sentinel-Objekte, die von den zugrundeliegenden std::variant Mitgliedsobjekten var gehalten werden. Zwei nicht vergleichbare Iteratoren oder zwei Sentinel-Objekte werden als gleich betrachtet.

Das Verhalten ist undefiniert, falls entweder x oder y sich in einem ungültigen Zustand befindet, d.h. x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) gleich true ist.

Lassen Sie i sein x. var . index ( ) und j sein y. var . index ( ) .

1) Wenn i == j (d.h. sowohl x als auch y Iteratoren oder beide Sentinels enthalten), gibt true zurück, andernfalls gibt std :: get < i > ( x. var ) == std :: get < j > ( y. var ) zurück.
2) Wenn i == 1 && j == 1 (d.h. sowohl x als auch y Sentinel-Werte enthalten), gibt true zurück, andernfalls gibt std :: get < i > ( x. var ) == std :: get < j > ( y. var ) zurück.

Der != -Operator wird synthetisiert aus operator== .

Diese Funktionsvorlagen sind für gewöhnliche unqualified oder qualified lookup nicht sichtbar und können nur durch argument-dependent lookup gefunden werden, wenn std::common_iterator<I> eine assoziierte Klasse der Argumente ist.

Inhaltsverzeichnis

Parameter

x, y - Iterator-Adapter zum Vergleichen

Rückgabewert

true wenn die zugrundeliegenden Iteratoren und/oder Sentinels gleich sind.

Beispiel

Diesen Code ausführen 
#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);
}

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 3574 C++20 variant war vollständig constexpr (P2231R1), aber common_iterator war es nicht ebenfalls constexpr gemacht

Siehe auch

(C++20)
berechnet den Abstand zwischen zwei Iterator-Adaptoren
(Funktions-Template)