Namespaces
Variants

operator== (std::common_iterator)

From es.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) (desde 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) (desde C++20)

Compara los iteradores y/o centinelas contenidos por los objetos miembro std::variant subyacentes var . Dos iteradores incomparables o dos centinelas se consideran iguales.

El comportamiento es indefinido si cualquiera x o y está en un estado inválido, es decir, x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) es igual a true .

Sea i igual a x. var . index ( ) y j igual a y. var . index ( ) .

1) Si i == j (es decir, ambos x e y contienen iteradores o ambos contienen centinelas), devuelve true , de lo contrario devuelve std :: get < i > ( x. var ) == std :: get < j > ( y. var ) .
2) Si i == 1 && j == 1 (es decir, tanto x como y contienen centinelas), retorna true , de lo contrario retorna std :: get < i > ( x. var ) == std :: get < j > ( y. var ) .

El operador != es sintetizado a partir de operator== .

Estas plantillas de función no son visibles para la búsqueda unqualified o qualified lookup ordinaria, y solo pueden ser encontradas mediante argument-dependent lookup cuando std::common_iterator<I> es una clase asociada de los argumentos.

Contenidos

Parámetros

x, y - adaptadores de iteradores para comparar

Valor de retorno

true si los iteradores y/o centinelas subyacentes son iguales.

Ejemplo

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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 3574 C++20 variant era completamente constexpr (P2231R1) pero common_iterator no lo era también hecho constexpr

Véase también

(C++20)
calcula la distancia entre dos adaptadores de iterador
(plantilla de función)