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 < std:: sized_sentinel_for < I > I2, std:: sized_sentinel_for < I > S2 >

requires std:: sized_sentinel_for < S, I2 >
friend constexpr std:: iter_difference_t < I2 >

operator - ( const common_iterator & x, const std:: common_iterator < I2, S2 > & y ) ;
(desde C++20)

Calcula la distancia entre dos adaptadores de iterador. Dos centinelas se consideran iguales.

Sea var el objeto miembro subyacente de std::variant en std::common_iterator , el comportamiento es indefinido si cualquiera de los dos x o y es inválido, es decir, si x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) es true .

Esta plantilla de función no es visible para la búsqueda unqualified o qualified lookup ordinaria, y solo puede ser encontrada 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 calcular la diferencia de

Valor de retorno

  • ​ 0 ​ si x. var contiene un objeto S y y. var contiene un objeto S2 , es decir, ambos contienen un centinela.
  • En caso contrario, alt_x - alt_y , donde alt_x y alt_y son las alternativas contenidas por x. var y y. var , respectivamente (ya sean dos iteradores o un iterador y un centinela).

Ejemplo

Ejecutar este código 
#include <algorithm>
#include <iostream>
#include <iterator>
int main()
{
    int a[]{0, 1, 2, 3, 4, 5};
    using CI = std::common_iterator<
                   std::counted_iterator<int*>,
                   std::default_sentinel_t
                   >;
    CI i1{std::counted_iterator{a + 1, 2}};
    CI i2{std::counted_iterator{a, 3}};
    CI s1{std::default_sentinel};
    CI s2{std::default_sentinel};
    std::cout << (s2 - s1) << ' '
              << (i2 - i1) << ' '
              << (i1 - s1) << '\n';
}

Salida: 

0 -1 -2

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

avanza el common_iterator
(función miembro pública)